PC-SIG: World of Education

home *** CD-ROM | disk | FTP | other *** search

/ PC-SIG: World of Education / PC-SiG's World of Education.iso / run / 0903 / grade.man < prev next >

Wrap

Text File | 1991-02-12 | 328KB | 7,337 lines

VAR Grade Grading Tools for Teachers Version 4.6 MANUAL This program has been written to assist you in the grading of your classes. Written by DENNIS REVIE (c) Copyright 1991 by Dennis Revie VAR Grade is COPYRIGHTED (C) 1987-1991 by Dennis Revie. All rights are reserved. VAR Grade can be distributed as SHAREWARE. It is not free. Baby Driver is licensed from Ithaca Street Software, Inc. COPYRIGHT (C) 1989. The programs INSTALLP.EXE and BDE.EXE are copyright Ithaca Street Software, Inc., and are included in accordance with the license. Comments and instructions from the Baby Driver manual have been used in this manual. VAR Grade is written in Borland International's Turbo Pascal. The files that can be listed by the "DIR *.BGI" (screen drivers) and "DIR *.CHR" (fonts) are copyrighted by Borland International and are used in accordance with the license. LHARC.EXE is Copyright (C) 1988-89 by Haruyasu Yoshizaki. PKUNZIP.EXE is Copyright (C) 1989-90 by PKWare, Inc. VAR Grade is dedicated to VAR, without whom neither the program nor the program author would exist. Diana E. Axelsen has been invaluable in preparing this manual: her assistance is gratefully acknowledged. Last Revision: Feb. 1991. DEFINITION OF SHAREWARE Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. DISCLAIMER - AGREEMENT Users of VAR Grade must accept this disclaimer of warranty: "VAR Grade is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of VAR Grade." VAR Grade is a "shareware program" and is provided at no charge to i the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using VAR Grade and continue to use VAR Grade after a reasonable trial period, you must make a registration payment of $30 (US), or $40 to also receive a laser- printed manual. Outside the US and Canada, registration is $40, or $55 for a printed manual, payable in US dollars on an international postal money order. This registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Schools, colleges, and Universities must register and pay for their copies of VAR Grade within 60 days of first use or their license is withdrawn. Site-License arrangements may be made by contacting us at the address listed below, and can be arranged on a per-school or per-user basis. Anyone distributing VAR Grade for any kind of remuneration must first contact us at the address below for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering VAR Grade immediately (However we must still be advised so that the distributor can be kept up-to-date with the latest version of VAR Grade.). You are encouraged to pass a copy of VAR Grade along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. All registered users will receive a copy of the latest version of VAR Grade, as well as the next significant upgrade. For users purchasing a printed manual, if a major update of the program occurs within 90 days, you will receive a new manual free of charge in addition to the free update of the program. To register, send the registration fee to the address listed below, or for an additional fee, as stated above, you will receive a laser-printed manual. This manual is the same as the on disk version, except that it includes figures and an index. ii Note that if you find any significant bugs, they will be corrected and a corrected version of VAR Grade sent to you as soon as possible. Registered users will have the opportunity to purchase further updates at a nominal cost (approximately 25% of the price of the current registered version). When you register please include your name, address, and the version of the program that you have. A suggested form is included with the program in the file REGISTER.TXT. If reporting bugs, please include the version of VAR Grade that you have, as well as: (1) The type of computer AND microprocessor 8088, 80286, ...). (2) The type of printer you will use with it. (3) The version of DOS that you are using (important for finding bugs). (4) List the bugs that you have found--and EXACTLY, if possible, how they occurred. This information is needed to find and correct the bug. (5) Also include any other suggestions for improving the program--wish lists, etc. For Registration or Information: Dennis Revie Attn: VAR Grade 4804 Highland Ave Oxnard, CA 93033-7818 CIS: 73427,112 _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Rd., Muskegon, MI 49442 or send a Compuserve message via easyplex to ASP Ombudsman 70007,3536. iii TABLE OF CONTENTS DEFINITION OF SHAREWARE....................................i DISCLAIMER - AGREEMENT.....................................i TABLE OF CONTENTS.........................................iv I. INTRODUCTION TO VAR GRADE...............................1 A. Program Features....................................2 B. Conventions Used in this Manual.....................7 C. Sample Classes......................................8 II. REQUIREMENTS...........................................9 A. Versions............................................9 B. Files on the Disks..................................9 C. Required Files.....................................11 D. Where Should the Files Be?.........................11 E. Networks...........................................12 III. INSTALLATION OF VAR GRADE............................13 A. Using INSTALL......................................13 B. Installation Without INSTALL.......................15 IV. FIRST USE OF VAR GRADE................................17 A. Printing the Manual................................17 B. Starting the Program...............................17 C. Using an Existing Class: Tutorial..................17 D. Starting a New Class...............................21 E. Entering Data......................................23 F. If You are Lost....................................24 G. Exiting the Program................................24 H. How Special Keys are Used..........................24 I. How the Cursor Keys Work...........................25 J. Using a Mouse......................................26 iv Table of Contents V. STARTING THE PROGRAM...................................27 A. Where Should the Program Files Be?.................27 B. Picking a Class....................................30 C. Converting Old Classes Into New Classes............32 D. Classes Too Big for the Memory.....................32 E. Setting Up the Class...............................33 F. Entering Students, Tasks, Attendance, and Grades...35 G. Reading the Manual and Help screens................36 VI. ENTERING STUDENTS.....................................38 A. General Methods....................................38 B. Names and IDs......................................38 C. Typing in Names and IDs............................39 D. Importing Students from Files......................41 E. Sorting Students...................................47 VII. DEFINING TASKS.......................................49 A. Regular Tasks......................................49 B. Special Tasks......................................51 C. Scaling Tasks......................................55 D. Memory Limitations.................................55 E. Manipulating Tasks.................................55 F. Examples of Task Definitions.......................57 VIII. ENTERING GRADES.....................................61 A. Entering Data for the Whole Class..................61 B. Entering Individual Student Data...................64 C. Saving Entered Data to Disk........................65 IX. ATTENDANCE............................................66 A. Defining Attendance Days...........................66 B. Changing Defaults..................................66 C. Entering Class Attendance..........................67 D. Entering Individual Student Attendance.............68 E. Default Attendance Task values.....................68 v X. ANALYZING THE GRADES...................................69 A. Default Values for Analysis........................69 B. Plotting the Scores of a Class.....................70 C. Plotting the Scores of an Individual...............72 D. Calculating Statistics.............................73 E. Correlating Different Tasks........................73 F. Statistical Plots of the Classes...................75 G. Scaling the Tasks..................................76 H. Setting the Fewest Allowed Points..................76 I. Assigning Standard Deviations and T-Scores.........76 J. Adjusting the Statistics of a Task.................77 K. Changing the Grading Names.........................77 L. Picking Automatic Grade Cutoffs....................78 XI. ASSIGNING AND PRINTING THE GRADES AND ATTENDANCE......79 A. Default Values for Analysis........................79 B. Printing the Student Scores and Attendance.........85 C. Calculating and Printing Grades....................88 D. Exporting Data.....................................89 E. Reports............................................90 XII. OTHER PROGRAM FEATURES..............................103 A. File Maintainance.................................103 B. Running Other Programs from VAR Grade.............106 C. Dates.............................................106 D. Video Displays....................................106 E. GrUtil.Exe........................................109 F. Examples of VAR Grade Batch Files.................112 XIII. APPENDIX...........................................115 A. Program Parameters--Defaults and Limits...........115 B. Backup Files......................................115 C. Beeps or Noises...................................117 D. Menus.............................................117 XIV. GLOSSARY............................................119 XV. FURTHER INFORMATION..................................122 A. Information.......................................122 B. Registration......................................122 INDEX....................................................123 vi Table of Contents The whole art of teaching is only the art of awakening the natural curiosity of young minds for the purpose of satisfying it afterwards. The Crime of Sylvestre Bonnard. Part II, Chapter 4. Anatole France (1844-1920) Each is given a bag of tools, A shapeless mass, A book of rules; And each must make, Ere life is flown, A stumbling-block Or a stepping-stone. Stumbling-Block or Stepping-Stone. Stanza 2. R.L. Sharpe [1890] vii I. INTRODUCTION TO VAR GRADE WELCOME TO VAR GRADE! This program has been written to be flexible enough to allow you to grade your class with the same methods you now use--except that the program does the tedious chores of adding, plotting, and writing the scores. The program has been written by and for teachers and requires no special knowledge of computers or MS-DOS. This manual will help both computer novices and computer experts get the most out of the VAR Grade program. If you are not an experienced computer user, the manual will show you how to get started with the program. Before putting data from your own classes on the computer, we suggest that you go through the tutorial in Chapter IV, First Use of VAR Grade, which uses a sample class to illustrate the steps in starting the program. If you are acquainted with MS-DOS and want to modify the program to meet your specific needs, the manual contains helpful information on doing so in Chapter V, Starting the Program. Menus are used to access all areas of the program. This "menu-driven" program should be easy to use, but you can also get help at any time by simultaneously pressing the <Alt> key and the key "H". One of the most powerful features of the program is its ability to analyze student grades in a variety of ways. The tutorials and additional material in Chapter IV will enable you to examine both individual and group performance using several different methods of data analysis. The calculations generated by VAR Grade will give you a great deal of information helpful in assigning final grades. Both you and your students will benefit from this data, since you can identify clearly how the student is performing relative to the rest of the class, and also evaluate the student's work on different assignments. The program also allows you to generate clear and attractive graphics, which will answer the question "why did I get this grade?" in detail probably beyond what any student would expect. The program can be used for both grades and attendance. You may grade with either letter or number grades, and you can mix and match letter and number grades. You can change the points of any assignment or score at any time. You can also use many different types of pre-defined assignments (tasks), including ones that are the sums, averages, and weights of other tasks. Any task or combination of tasks can be plotted, correlated, and 1 analyzed statistically. Attendance for your classes can be recorded. Several categories of attendance are defined by VAR Grade. Individual student scores can be printed or scores for each section of the class can be printed. You can control page length, margins, and type size when printing the data. The program has also been designed to be as immune as possible from errors on your part. The program checks for reasonable task scores, will not easily let you exit the program without saving your data, and will check to ensure that the data sent to a disk was actually written before letting you exit from the program. It will also prevent accidental deletions of your files by making them read-only files (which you cannot delete with the DOS "del" or "erase" commands). You can also protect your grades from prying eyes by requiring a password before allowing access to your data. The program has been in use for several years, and has undergone constant improvements and corrections. However, suggestions are always welcome for additions, deletions, or improvements to the program. Please send comments! Most of the recent changes in the program were suggested by people using this program. A. Program Features An unlimited number of students, tasks, and classes of students are allowed by VAR Grade. Only the amount of memory in your computer limits these. 1. Entering the students You can enter the students either by entering their names directly into the program, or by telling the program to use a file of names for the students. The "N" option on the Main Menu will allow a choice between these alternatives. See Chapter VI, Entering Students, for further information. You can sort and list students several ways, including by names, IDs, sections, and task scores. You can display and print students by their names or their IDs. These can be Changed in the "Z" option of the Main Menu. 2. The number of sections The number of sections is initially set at 1 when you first start a new class. For elementary schools, that is probably all that you will need. For high schools and colleges, 2 Introduction several sections of the same class are frequently given by the same instructor. There is a limit of 254 sections of students in the class. 3. Tasks Below is a quick overview of tasks. For more information, see Chapter VII, Defining Tasks. Tasks can be defined or changed in the "T" option of the Main Menu. Besides defining tasks, there is a full retinue of tools to manipulate the tasks after they have been defined. (a) Regular tasks There are ten types of tasks allowed. Two of them correspond to ordinary number and letter grades. These can be defined in the "T" section of the Main Menu. You give a task a name, then, if it is a number task, the total allowed points for the task. (i) Number tasks are ones in which you enter numbers as the grades. (ii) Letter tasks are ones where the scores are entered as letters. (iii) Extra credit tasks are ones where the points are added to a number task, but the total points of the number task are not altered. Extra credit tasks are treated in special ways by the program. As far as the special exams below are concerned, they have 0 total points. (b) Special tasks The second type of tasks are called Special tasks. These pre-defined tasks are also be specified in the "T" section of the Main Menu. Special tasks are Sums, Averages, Highest, Percentages, etc., of other tasks. You do not enter scores into special tasks. Instead, you pick the tasks to be counted in the sum (or average, percentage, highest, etc.) of other tasks. The program then calculates the scores for you. These scores will be recalculated each time you change student scores. (i) Sum tasks 3 These are tasks that are the sums of other tasks. Tasks that are not yet entered can be included in the list of tasks that will be summed. When the tasks are then defined, they will be included in the sums. (ii) Averaged tasks These are tasks that are the average of other tasks. If you use letter grades, the averages are reported as scores between the highest (e.g., A) and the lowest tasks (e.g., F), otherwise they are the numerical average of the tasks. Any tasks that have not yet been entered are not averaged, so the averages reflect only those tasks for which the student has had scores entered. (iii) Percentage tasks These are tasks that average other tasks, then convert those averages to percentages. Like averaged tasks, any tasks that have not yet been entered are not used in the conversions, so the percentages reported for the students are for the tasks that have had scores entered. (iv) Highest tasks These are tasks that sum the scores of other tasks, then the lowest one or more scores are discarded ("throw out the lowest of several scores"). The program will find the lowest of a set of tasks and add up only the highest tasks. Scores that are unentered are discarded first, then the lowest scores that have been entered are discarded. (v) Weighted tasks You can define a task as the sum of other tasks, each worth a certain weight. (vi) Attendance tasks Not only can attendance be taken (see below), but the attendance can be given values to be used as part of the final grade. (vii) Final tasks 4 Introduction You can define a task as a final task. Letter grades are assigned based upon grade cutoffs specified by you. 4. Attendance On the "A" option of the Main Menu, you can have VAR Grade also keep attendance for your class. There can be up to 240 days of attendance, with several different types of attendance (present, absent, late, etc.). The characters that represent each attendance type can be changed from the Attendance Menu. 5. Notes Besides names and IDs, you can enter notes of up to 20 characters for the students. The notes can be anything, including why a student missed an exam, seat numbers, nicknames, etc. These notes can be printed along with your grades. 6. Entering data Scores and attendance can be entered spreadsheet style. Students and their data are listed either by individual students or by the whole class. Data entry is checked for valid input, so no scores can entered that have more than the allowed points. 7. Writing the scores Using the "W" option of the Main Menu, there are two ways you can print scores. First, you can print the scores of one student OR the scores you want for an entire class or combination of sections of the class. After choosing which way to write out the scores, a menu will be displayed that will list a number of options for printing on the Print Menu: which sections, what printer, and whether to write to the screen only, or also to a disk file or a printer. Thus, the Print Menu allows great flexibility in how the program prints the data. Second, the program allows you to write your own "report forms" so that you can print the scores just about any way you want. 8. Plotting the scores 5 In the "P" option of the Main Menu, you can plot and graph the scores of any task you choose. If you grade with numbers, you also choose the low and high scores to plot. You can also plot all the scores for one student in the "I" option of the Plotting Menu. You can correlate scores on two tasks. The scores will be plotted against each other and the correlation coefficients calculated. You will be asked for the high and low scores for each exam, just as when plotting exam scores. You can also plot the class scores for any task or set of tasks. Ranges, means, medians, and standard deviations are calculated and plotted. All the plots can be displayed using several fonts, and the results printed on your printer. 9. Define a grading system You can pick just about any grading system you want, simply by renaming the grades and changing their points. You can also have the program automatically assign grades according to your grading scale. These and other options are available in the "G" option of the Main Menu. 10. Assign final grades At the end of an task or semester, you can assign grades and have the grades and grade cutoffs neatly printed using the "G" option of the Main Menu. If you use number grades, you also can weight exams by adding or multiplying the current scores by a number, and/or calculate statistics on tasks (without plotting scores). 11. Printers You can tell the program which printer that you are using. In fact, to be able to print graphs and plots, you need to pick a printer during installation or on the "Z" option of the Main Menu, with section "P". Virtually every printer is now supported by VAR Grade for printing graphs and plots. Most are also supported for printing files in pica, elite, and compressed characters (if your printer supports them). For unsupported printers, you can find the codes in your printer manual, and enter the necessary codes to support your printer. 6 Introduction 12. Passwords If you keep your grades on a computer that is accessible to others, you can prevent most people from "browsing" in the student data by telling the program that you want to use a password. The password can be up to 15 characters long, and can include spaces and punctuation marks. Passwords can be changed in the "Z" option of the Main Menu. 13. Other program features Anytime that you want to change some of the current settings of the program, you can use the "Z" option on the Main Menu. Some of these are listed above. Among other changes, you can change (a) the colors of the characters and background, error messages, help screens, and graph points, (b) the lines on a screen, (c) the number of decimal places to use when writing scores, and (d) the ways dates are displayed. B. Conventions Used in this Manual Names of files and programs are printed in UPPERCASE letters. Warnings and notes are printed in italics. Examples of what to type are in double quotes: "TYPE THIS". MS-DOS prompts are usually listed as: A>. Anything after the prompt should be typed. Example: A> GRADE The prompt is A>, and you should type "GRADE". Special keys are those that do not print normal (ASCII) keys. They are designated in the manual and program by bracketing the key name with "<" and ">". Example: <Esc> means the Escape key, <Rtn> means the Return or Enter key. C. Sample Classes To look at the capabilities of VAR Grade, four sample classes called GSample, A, B, and C have been included. Many of the features of the program have been used for these classes. To view them, type "GRADE GSAMPLE", "GRADE A", "GRADE B", or 7 "GRADE C". These classes are also used for tutorials and figures in the manual. 8 Requirements II. REQUIREMENTS 1. This program will run on an IBM PC or compatible computer. 2. It requires MS-DOS 2.0 or later. 3. It requires at least 300,000 bytes of free memory (memory LEFT after DOS and memory resident programs like Borland's SidekickTM are running). If you have 384K memory or greater in your computer you should have no problem running VAR Grade. 4. Two 360K disk drives or one drive of 720K or more. A hard disk is recommended. 5. The program can run using either a monochrome or a color monitor. To see graphs and plots, you need a display adapter that can display graphics (e.g., Hercules, CGA, EGA, VGA, and others). If you want to print graphs and plots, a dot matrix, ink jet, or laser printer is required. Grades can be printed on any printer. A. Versions The standard version of this program allows you to have up to 16,000 students in up to 254 sections or groups per class, up to 8,000 tasks per class, 240 attendance days per class, and an unlimited number of classes. In reality, the limitations are due to available memory. Should you desire "custom" versions of this program, they are also available. When you register your current version, should you desire a custom version, indicate so and we will try to meet your requirements. The program automatically uses a math coprocessor chip (8087 or 80287, etc) if one is installed. 9 B. Files on the Disks Disk #1: README.BAT Lists Readme.46 to the screen. README.46 Introduction to VAR Grade. PKUNZIP.EXE Archive program used to extract files. Alternatively, LHArc.EXE may be included. If LHArc is used, all files ending in "ZIP", below, will end in "LZH". INSTALL.EXE Installation program for VAR Grade. GRADE1.ZIP Archive of the following files: GRADE.EXE This is the main program. GRADE.OVR This is the overlay for the program. GSAMPLE.PAR Sample class data. GSAMPLE.DAT Student data for the GSample class. REGISTER.TXT Registration form. A.PAR, B.PAR, C.PAR Sample classes. A.DAT, B.DAT, C.DAT Sample classes. Disk #2: PKUNZIP.EXE Archive program used to extract files. GRADE2.ZIP Archive of the following files: GRADE.HLP The file containing help screens. INSTALLP.EXE The program that installs printers. GPRTDRV.PDT Printer drivers (for INSTALLP). *.BGI Screen drivers for VAR Grade. *.CHR Fonts for the screen drivers. *.FRM Sample report forms. GRADE.MAN The VAR Grade Manual. GRUTIL.EXE Utility program used to load students into classes or print grids of the classes. Disk #3: BDE.EXE Program to change printer codes. NOTE: This program is included with the registered version. However, unregistered users may obtain a copy of it by sending $10 for postage and handling to the address listed above for registering the program. The installation program will generate another file, GRADE.PDT. This file contains information needed to print graphs and 10 Requirements screens. After the program is run, an additional file is created, called GRADE.PRT. This file contains information used for printing text from VAR Grade. C. Required Files For the program to run, it requires: GRADE.EXE (program) GRADE.OVR (overlay) The following files are needed for graphs: ?.BGI (which one depends upon your display adapter) GRADE.PDT (to print graphs) *.CHR (to change fonts for graphs) The following files are used for installing printers: INSTALLP.EXE (installs new printers) GPRTDRV.PDT (printer codes, needed by Installp) The following are utilities, only: BDE.EXE (to change printer codes for a printer) GRUTIL.EXE (to print grids and make classes from batch files) D. Where Should the Files Be? 1. If you have DOS 2.X The required files can be in the default directory or drive, they can be anywhere in the directories specified by the DOS PATH command, or they can be in the default directory of any drive. 2. If you have DOS 3.X or later The program can be invoked from any drive or directory if the required files are in the same directory as the program. Otherwise, the files can be in the default directory or drive, they can be anywhere in the directories specified by the DOS PATH command, or they can be in the default directory of any drive. 11 E. Networks This version will run on networks (LAN). It will not, however, take advantage of special features of the networks, such as interactive mail or print queues. To be able to use any video driver, you need to copy all the video drivers onto your network hard disk. This can be done by dearchiving all the files ending in "BGI" from the archive file GRADE2.ZIP (or GRADE2.LZH). See Chapter III, part B for details on how to unarc the files. 12 Installation III. INSTALLATION OF VAR GRADE When you obtain VAR Grade, it will be on disks. The program can be run directly from those disks; however, some of the files are not required, and some of the files are better placed onto other disks. Therefore, a program has been included on Disk #1 that will set up new disks for you that has the correct files on the correct disks. VAR Grade can be installed onto either a hard (fixed) disk or onto floppy (removable) disks. The program INSTALL will automatically install VAR Grade. You will need to answer some questions and follow the instructions, but will not have to worry about what files are needed where. If you prefer to install the program yourself, directions are given below in Section B. A. Using INSTALL To install the program, you can run the program INSTALL. Follow the instructions below. INSTALL will not modify any existing files on your computer. 1. Put Disk #1 (the "Program" disk) into a drive. It can be in any drive. 2. You will need 4 blank, formatted 360K double-sided floppy disks, 2 720K 3 1/2" disks, or 1.2 megabytes of free disk space on any other disks. If the disks are not formatted or not empty, they can be formatted during the installation. NOTE: The program uses the MS-DOS format command for formatting, and will only format disks of 1.44 Megabytes capacity or less. Put one of these disks into the drive you will install the program onto. If you are installing onto a hard disk, you will not need any floppy disks. 3. Type "INSTALL". An opening screen will appear, explaining the requirements for VAR Grade and how to use the installation program. If you have a monochrome monitor, you may need to type "INSTALL/b" to force the program into black and white mode. This may be required for some monochrome boards, as these boards sometimes tell programs (erroneously) that they are color boards. "INSTALL/c" will force the program into color mode. 13 4. You can exit the installation program, at any time, by pressing the "Ctrl" and the "C" keys simultaneously (<CtrlC>), or by pressing the "Ctrl" and the "Break" keys simultaneously (<Ctrl-Break>). If the program has not completely installed the program, you may have to start over. 5. After pressing a key, you will be asked for the directory where you will be putting the program. If you have only two disk drives, the program can be installed onto either one of the two drives. The program will suggest a drive, but you can change it if you want (e.g., to change it to drive A, delete the suggested name by pressing the function key <F10>, then typing "a:", then press <Enter>). If you have a hard disk, the program will install the files onto the directory that you specify. The program will suggest installation onto "C:\VARGRADE", but you can change it to any other directory and/or drive. If you get a "beep" and error message, it probably means that you haven't yet put a disk into the drive. 6. The program will now install the program. If it does not find the disks or files it needs, it will request that you put them into the appropriate drives. If the disk does not have enough room on it for the VAR Grade files, you will be asked what to do. There are three options: (a) You can format the disk. This is probably the best option. (b) You can tell the program to write the files to another disk, or (c) You can tell the program to write the disk anyway. Choose this option if you have changed the disk or if you are installing VAR Grade onto a previous version of the program. If a previous version of the program is present, the installation program will ask if the existing files should be replaced (overwritten). Note that you will only be asked this once: if you say yes, all the duplicate files will be replaced. During the installation, the program will ask you to pick your printer. NOTE: if your computer cannot display graphics, this part will be skipped by the installation program. To do this, you will need the name and model number of your printer. Use the arrow, page up, and page down keys to traverse the list and find your printer. Then press the <spacebar> to select it. You can repeat this process until you have picked up to 5 printers. When you have picked all your printers, press <F10>. A file called 14 Installation GRADE.PDT will be created that has the necessary information. 7. If there is not enough room on the new disk for all the fonts, they will be put on the disk with the Manual. If you decide not to use all the fonts, there should be room on the disk for a couple of the fonts. 8. When the installation is completed, a message will be displayed explaining how to label the disks and how to start VAR Grade. 9. When you run VAR Grade, the disk with the overlays needs to be in the drive at all times. Part of the program is in "overlays", which means that some of the program is on the disk and is read into the program when needed. NOTE: If you have removed the overlay disk, the program will print a message asking you to insert the overlay disk, as it needs the overlay file to continue. Also, do not move the disk with the overlays from one drive to another. It must always be in the drive that it was in when you started VAR Grade. B. Installation Without INSTALL To install the program without INSTALL, follow the instructions below. 1. You need up to 1.2 megabytes of disk space. 2. The simplest method is just to copy all of the files from the disks onto a directory of your drive. Then type "PKUNZIP GRADE1" and then "PKUNZIP GRADE2". This will cause the archiving program PKUNZIP to extract all the files. If LHARC is on disk #1 instead of PKUNZIP, extract the files with "LHARC x GRADE1" and "LHARC x GRADE2". 3. If you don't have enough room on that drive, the files you need are: GRADE.EXE, GRADE.OVR: which needn't be on the same disk. A .BGI file: Which one you need depends upon your display adapter. The name of the file corresponds to the display adapter (e.g., HERC.BGI is for Hercules adapters). This and the following files are needed only if you want to view graphs of the grades. A .PDT file: You need to run INSTALLP to install your printer. Start it by typing "INSTALLP GPRTDRV.PDT GRADE.PDT 5", then select your printer(s) (see step A6, above). If you have a monochrome monitor, you need to add start the program with "INSTALLP GPRTDRV.PDT GRADE.PDT 5 - 15 m" to force INSTALLP into monochrome mode. To add or delete printers from VAR Grade, INSTALLP and GPRTDRV.PDT need to be with the program. *.CHR files: To change fonts for the graphs, the CHR files need to be with the program. These files can be removed from the archives GRADE1 or GRADE2 archives (as listed above), by typing "PKUNZIP GRADEx filename", where GRADEx is one of the two GRADE archive files, and filename is the name of the file. If LHARC is included instead of PKUNZIP, type "LHARC x GRADEx filename". Example: to dearchive GRADE.EXE, type "PKUNZIP GRADE1 GRADE.EXE". NOTE: Chapter II, section B, lists which archive contains which VAR Grade files. 4. The only files that are absolutely required are the program (GRADE.EXE) and the overlays (GRADE.OVR). 16 First Use IV. FIRST USE OF VAR GRADE In general, you move around the program by choosing options on menus. The "Main Menu" is the menu that appears after specifying a class name. If you choose one of the options on the Main Menu, the program goes to another set of menus ("secondary menus"), etc. Below is a short description of how to enter data for a new class, as well as a list of some of the features of the program. A. Printing the Manual You can print the manual by typing, at the DOS prompt: A> COPY GRADE.MAN PRN NOTE: The manual is over 100 pages long. B. Starting the Program 1. Type "GRADE" when in DOS (i.e., at the prompt: A> ). If you have a monochrome monitor, type "GRADE/B". For more details, see Chapter V, Starting the Program. 2. You will then be asked for the name of a class. A class will be highlighted on the screen. Press <Rtn> to select that class, or use the arrow keys to move the highlight to a new class before pressing <Rtn>. To access any class not listed on the screen, type the name and press <Rtn>. If the program cannot find the class, it will make a new class with that name. Class names can be corrected with the <Backspace> key. After a class has been selected, the Main Menu then appears. This chapter will describe both how to start a new class and how to use the class supplied with the program. C. Using an Existing Class: Tutorial Start the program as in section A. Next, you will see four classes highlighted, GSample, A, B, and C. Move the highlight to GSample. Press <Rtn>. VAR Grade will now read the students into the program. 17 A menu will appear. This menu is called the Main Menu. On it are several options. These options are separated into four categories. First, there are several options involved with entering data. Second, there are options regarding analyzing the student data. Third, there are other options, such as changing how parts of the program work, seeing the help screens, and running other programs. Last, there are options for leaving the class and program. You can use the arrow keys to move the highlight to a different menu choice. To pick a choice, either move the highlight to the desired choice, then press <Rtn>, or just press the key shown on the left side of the highlight. If you have a mouse, you can move the mouse cursor to the desired choice, then press the <left button>. 1. Entering data Press "D" on the Main Menu. You will see a list of students in the class and scores for several of the tasks that have been defined. Use the arrow keys on the keypad to move around the class. (a) Names Move to the second name, "Axelsen, Diana". The cursor will be at the end of the name. Press the backspace key. Next press an "e". The name will now read "Axelsen, Diane". (b) Number tasks Move down to "Crick, Francis". Now move right two cells to the number "80.00". If you look to the top of that column, it will say that it is task #1, with the name "Number 1". The cursor will be at the end of the number. Press the backspace key 4 times. Now type a "5". The number should read "85". Move down one cell with the down arrow. Notice the 85 stays in the previous cell. You do not have to type a <Rtn> to signal the end of input; just moving to another cell with the cursor keys is sufficient. NOTE: Scores higher than the allowed points for a task will not be accepted. A beep or noise will tell you this has happened. 18 First Use (c) Letter tasks Now move to "Darwin, Charles". Move right three cells, to a "B". This is in the column: task #2, "Lette". The "Lette" is the first five letters of "Letter 2", the name of task #2. Only the first few letters of each task name is shown (to show all the letters takes too much screen space). To change the task score, use the backspace key to delete the B, then put in a new grade, from A to F. Notice that if you type any other letters, they will be ignored by the program. Only valid letters are accepted. (d) Scrolling to the right From "Darwin, Charles", task #2, move right four cells with the right arrow key. Notice that when you moved to the fourth cell, the screen shifted to the right. The names are still listed on the left, but a slightly different set of tasks is shown. If you want, you can change the score as before. (e) Scrolling down Just as in the previous example, you can also scroll down. This time you will see more names. Use the down arrow on the keypad to go all the way to the last person in the class. Notice that the screen shifts as you do so. You can scroll through the students and tasks until you find the data you want to change. (f) Changing which data is displayed To change which data is listed on the screen, press <AltC>. You will see the Display Menu, which asks whether to display the name, ID, or both. Choose "B", for both. If there had been more than one section of students in the class, you would be asked whether to display section numbers. In GSample, there is only one section of students. Next, you will be asked whether to display notes. Press "Y". Last, you will be asked which tasks to display. Type "1 3:2", then <Rtn>. You have told the program to list tasks 1, 3, and then 2 on the screen. You will now see the names, IDs, notes, and task scores for tasks 1, 3, and 2. You can display any regular tasks (number, letter, or extra credit), in any order. You could now alter the data, if you wished. 19 (g) Exiting To leave this part of the program, type an <AltS>. The data you changed will be saved into memory. 2. Analyzing grades We can see a plot of the scores on task #1 by pressing "P" when we are on the Main Menu. Next, press a "T" (for three dimensional). You will be asked which task to plot. Type in a "1", then a <Rtn>. Next, you will be asked for the high score to plot. Just type a <Rtn> to allow the program to choose the highest score. Next, you are asked for the low score to plot. Again, just type a <Rtn>. You have told the program to pick the highest and lowest scores in the class as the highest and lowest points to plot. You will next see a menu, the Print Menu, that will list several options, such as printing to a printer, disk file, etc. Just press "S". The program will display the plot. At the bottom right of the screen is a message: "Press any key to continue." When you are through looking at the plot, press a key. You will return to the Plot Menu. Press an "X" or <Esc> to exit back to the Main Menu. 3. Writing scores If you want to list some of the task scores of the class on the screen, press a "W" when on the Main Menu. You will see another menu, the Write Data Menu. Press an "S". This will display the scores of all the students in the class. You will be asked whether you want to display task scores, attendance, etc. Pick "T", task scores. You will then be asked for the list of tasks to display. Type "1:4", then <Rtn>. You have just told the program to list the first four tasks in the class. Next, you will be asked if you want to display the student names, and/or IDs. Press "B" to display both. Last, you will see the Print Menu. Press "S" on the Print Menu to see the scores. The listing will stop at every screenful of students. When the screen stops, press a key to see some more data. When you have seen all the scores, the Write Data Menu will appear again. Press "X" or <Esc> to go back to the Main Menu. 4. Quitting the program Press "Q" on the Main Menu to leave the class. Since we changed some of the data, the program will ask you if you 20 First Use want to save the data before exiting. Press "N" (don't save the data). D. Starting a New Class Start the class as in section A. This time, instead of pressing <Rtn>, type in a name of a class. The Main Menu will then appear. 1. First, if there are more than one section of students in your new class, you will need to increase the number of sections. You can have up to 254 sections of students in each class. Press "Z" when on the Main Menu. On the second menu, press "S" (change the number of sections). Type in the new number, from 2 to 254, then <Rtn>. Then exit back to the Main Menu by pressing "X" or <Esc>. If you have several classes that use the same tasks and turn in the same assignments, calling them different "sections" of the same class lets you easily compare them. 2. Next, you want to enter the names of the students. Enter the names by pressing "N" on the Main Menu. There are several choices. You can type in only names ("N"), type in names and IDs ("I"), or load the class names from a files ("F", "A", "C"). Name, IDs, and sections can be changed at any time. If you choose "N" or "I", you will be asked for the section in which to add students. If you are typing in the names, just enter the names (ending each name with <Rtn>). If you are also typing in IDs, type them in, too. If the previous name was entered incorrectly, you can delete it by moving to it with the cursor keys, then retyping it. When you have finished entering names, press <AltS>. Example: If you are on the Main Menu, type an "N", then "N" again. The program will ask for the section number. Type in the section number, then <Rtn>. You can now type in names, ending each with a <Rtn>. If you misspelled a name, but did not notice until you were on the next name, press <UpArr> to delete the previous name. Retype it in correctly. After the last name has been entered, press an <AltS>, and an <Esc> when the program asks for the section number. NOTE: The program sorts the names alphabetically. If the names are entered last name first, they will be sorted by last name. If they are entered with the first name first, they will be sorted by first names. The program will check for duplicate names, so you cannot put the same name into the same section twice. 21 If you are entering names from a file, the program will ask for the name of the file. Flat files are ones where the names, IDs and exam scores are in columns. For the "F" (flat file) option, you need to tell the program where the names and IDs are located in the file. Names longer than 20 characters will be truncated, as will IDs longer than 15 characters. If there are no IDs, sections, or exams, just tell the program to start at "0" for them. For the "A" (automatic flat file) and "C" (comma) options, the program will try to make sense of the names. Comma and quote delimited files are readable by most spreadsheets. See below, Chapter VI, Entering Students, for more details on loading students from files. 3. Tasks are assignments for students. They can be exams, tests, homework, projects, etc. If you have task scores to enter into the program, press "T" when on the Main Menu to define the new assignments. The second menu will ask you for the number of the task. You will then be asked the name and total points of the task (if it is a number exam). You can continue to define as many tasks as you like. There are ten different types of tasks that can be defined. You must define a task before you can enter task scores. Note that if you are grading by numbers, no scores can be entered that are either higher than the total points of the task. If you are using letter grades, only letters defined by you can be used (the "default" grades are A to F, with + and - grades, but these can be changed). 4. Next, you can use either the letters as defined by you, or the "default" grades to enter the scores. Pick the number of the task or tasks that you want to use. You may enter scores for multiple tasks or for only one. You then can enter the scores "by individual" ("I" on the Main Menu), or "by section" ("D" on the Main Menu). "By individual" lists all the tasks for one student, while "by section" or class lists for every student in the class only those tasks that you have picked. With either method, the program lists the students by the whichever sort method you have chosen (e.g., alphabetically by name). You can use the cursor keys (up, down, etc.) to move to a new task or student. Pressing <Rtn> will cause the program to move to the next task, while using the cursor keys will move you up, down, or over to new tasks. NOTE: If you are "using" edit keys, you move between students with <Ctrl>-cursor keys. 22 First Use 5. When you are finished entering data, press <AltS> to exit the section and save the data to memory. Next, when on the Main Menu, type an "S" to save the data to a disk file. The program will ask for the class name. Most of the time, you will just type <Rtn>. If you want to change the name of the class or the directory where it is located, you can do so before pressing <Rtn>. E. Entering Data In general, if you are asked to "enter" data, end it with "<Rtn>" or a cursor key, when you are asked to "press" a key, only one key needs to be pressed. 1. Menu choices The program accepts as input only the keys listed on the menu, and will respond to the key when it is pressed. When you are asked for a menu choice, to select it you can (a) press the key, OR (b) use the cursor keys to pick the correct choice and press the Return or Enter key, OR (c) use a mouse to select the choice and press the left button. 2. Entering numbers When you type numbers in, you must press the return key (<Rtn>) or, a cursor key (arrow, page up and down, etc.) to signal the end of your data. A <Rtn> alone, with no number, tells the program: (a) do not change the current value; OR (b) end current input of the number; OR (c) let the program choose the appropriate number. Which possibility (a, b, or c) that the program will use is stated when the data is requested. 3. Selecting and entering names When you enter words or names, you must press either the return key (<Rtn>) or a cursor key (arrow, page up and down, etc.) to signal the end of your data. When names of classes or students are listed on the screen, the cursor keys can be used to select the student or class 23 name. Select the desired name with the cursor keys, then press <Rtn>. F. If You are Lost If you are lost, or want to return to the Main Menu, you can usually reach it by repeatedly pressing the <Esc> key. G. Exiting the Program Normally, you exit the program by going thru the Main Menu. To exit, pick the "Q" (quit the program) option. If any data has been changed, the program will ask if you want the changes to be saved. You can also exit from almost anywhere in the program by pressing Ctrl-C (the Control key and the "C" key simultaneously: <CtrlC>). Again, if student data has been changed, you will be prompted about saving it before leaving the program. The key combination Ctrl-Break has no effect while in the program. H. How Special Keys are Used These keys are not used in all parts of the program, but will be used in most parts. Other keys are also used, but these are listed on the screen when they can be used. Key Name of key Program Function <Esc> Escape Exit this program section. <Rtn> Return, Enter End of input. <Pg Up> Page Up List previous screen. <Pg Dn> Page Down List next screen. <Home> Home Go to the first screen. <End> End Go to the last screen. <Tab> Tab Move to the next entry (cell). <ShftTab> Shift-Tab Move to the previous entry. <F1> Function key 1 Use all choices, or select the next available choice. <F10> Function Key 10 To delete current entry. <AltH> Alt-H HELP--always available. <AltU> Alt-U Undo that field when entering numbers or words. <CtrlE> Control E Switch between how the cursor keys work (see below). <CtrlC> Control C Exit from the program. If data has been changed, you will be asked whether it should be saved before exiting the program. 24 First Use Key Name of key Program Function <CtrlS> Control S Stop writing to a printer or disk. I. How the Cursor Keys Work You have options as to how you want the cursor keys to work. If you do not redefine the functions of the cursor keys, they will work as follows: Key(s) Movement <Home>, <Ctrl-Pg Up> Go to the first name or cell <End>, <Ctrl-Pg Dn> Go to the last name or cell <Pg Up> Go up one screen <Pg Dn> Go down one screen <Left Arrow> Go left one cell or column <Right Arrow> Go right one cell or column <Ctrl-Home> Go up one half column <Ctrl-End> Go down one half column <Up Arrow> Go up one name or line <Down Arrow> Go down one name or line <Ctrl-Left Arrow> Go left two columns <Ctrl-Right Arrow> Go right two columns <Backspace> Delete previous character You can switch between using or not using edit keys by pressing <Ctrl-E> (simultaneously press the "Ctrl" and "E" keys) anytime you are entering numbers or names (strings of characters). Furthermore, if you choose to use edit keys, you can use "insert" or "overstrike" modes. Just press the <Ins> key to switch between these modes. In insert mode, the characters are inserted at the position of the cursor, with the rest of the characters pushed to the right. In overstrike mode, the character typed replaces the one at the cursor. If you "use" edit keys, by redefining their functions, you will be able to move left or right in the data with the cursor keys functioning as they would in a word processor. If you switch to "using" the edit keys, they will be redefined as follows: Key(s) Movement <Home> Go to the first character. <End> Go to the last character. <Left Arrow> Go left one character. <Right Arrow> Go right one character. <Ctrl-Left Arrow> Go left one name or cell. <Ctrl-Home> Go left four names or cells. 25 <Ctrl-Right Arrow> Go right one name or cell. <Ctrl-End> Go right four names or cells. <Del> Delete the character at the cursor. <Ins> Switch between Insert and Overwrite modes. J. Using a Mouse If you have a mouse, it can be used by the program. The mouse cursor is a box, larger than a character, and is seen on the screen as having different colors than the surrounding text. Both two and three button mice are supported. NOTE: Mouse drivers over two years old may not work correctly. You should get a new one from the manufacturer of the mouse. Mouse button(s) Meaning --------------- ------- <Left button> Select. If the button is pressed while the mouse cursor is at a menu choice, that choice will be selected. If the mouse cursor is at a number or name, the cursor will move to that place. If the mouse cursor is outside the current window, this will usually cause that window to close. If the mouse cursor is inside a window, but at no choice, number, or name, nothing will happen. If there is more information than can be seen on one screen, "mouse bars" will appear on the right and/or bottom of the current window. Pressing on these bars will move you the screen to a different part of that information. <Right button> Escape. This is equivalent to pressing the escape key. <Left & right buttons> Return (enter). This is equivalent of pressing the <Rtn> key. Where the cursor is located determines what action is taken by the program. <Center button> [Three button mice, only.] Clear the name or number. Equivalent to pressing the <F10> key. 26 Starting the Program V. STARTING THE PROGRAM This part of the manual tells you how to start the program, including where to place your files, where to put your class grades, and how to locate class files from the program. It will also explain how to access help and the manual from the program. You should have already installed the program (see Chapter II). A. Where Should the Program Files Be? 1. For DOS beginners Before starting the program, make sure that all the program files listed above in Chapter II, Requirements, are in the current directory of one disk, or, if the program has been installed onto floppy disks, on the current directories of two disks. At the DOS prompt, type: "GRADE" If you are not a DOS expert, go to section B. 2. For DOS experts The program will search the current environment for the program files. This means that the search for the files are in the following order: (i) It searches the current directory first. (ii) It then searches for the files in the directory where the "GRADE.EXE" file was found. (iii) It then searches the directories specified by the DOS PATH command. NOTE: The PATH command tells DOS which directories to search for executable files: those ending in ".COM", ".EXE", or ".BAT". (iv) If it still hasn't found the files, it searches the default directories on each drive in your computer. (v) If the program files are still not found, the program will halt with an error message. 27 The required files, therefore, are most logically placed in one directory of a hard disk or on two floppy disks, as is done by INSTALL. (a) MS-DOS 3.X or above The program can be started from any directory by just typing the directory and "GRADE". For example, if the program is in the directory c:\class, just type "c:\class\GRADE". If the program files are in the same directory as the GRADE.EXE file, the program will find the files it needs. Note that this will only work in DOS 3.X, not in DOS 2.X. (b) MS-DOS 2.X Because the program can find the necessary files if the program has been installed correctly, you can then keep the program files in one directory, and the class files in another. Just make sure that the PATH command specifies the directory where the program is located. Read your MS- DOS manual for directions on how to use the PATH command. If you know the name of the class that you want to grade before you enter the program, you can enter the class name as a parameter on the command line: e.g., if the class is called "BIOLOGY", type "GRADE BIOLOGY" at the DOS prompt. The BIOLOGY class data will automatically be read into the program. The class name can include a path, so, if the BIOLOGY class is located in the c:\science directory, you can start the program with "GRADE C:\SCIENCE\BIOLOGY". (c) Examples (i) If the program is on the same drive as the class (the "A>" is the DOS prompt): For example, type: A> GRADE If the program is on a different drive, type the drive, colon, GRADE. For example, if you are on drive A, and the program is on drive B, type: A> B:GRADE 28 Starting the Program The program will find the overlay, print, and help files if they are on the default directory or on any directory specified by the path command. (ii) If you know the name of the class that you want to use, enter it on the DOS command line: A> GRADE classname OR A> GRADE \path\classname (iii) If you are using a hard disk, you may want to set up a batch file that will do the typing for you: Batch file example: If GRADE (including the necessary files) is in the directory, C:\CLASS, prepare a batch file that says: SET PATH=C:\CLASS; GRADE OR SET PATH=C:\CLASS; GRADE classname (iv) If you are using DOS 3.X, you can start the program by typing the directory and "GRADE": If VAR Grade is in the directory C:\CLASS, type C:\CLASS\GRADE OR C:\CLASS\GRADE classname (v) If you have a monochrome monitor, you may need to start the program with: GRADE/B classname This will force the program into monochrome mode. Many Hercules compatible display adapters erroneously tell programs that a color monitor is attached. The results are that some color combinations are invisible to you. 29 You can also force the program into monochrome mode with a DOS SET command: A> SET VMON=BW; You can set up a batch file for VAR Grade as follows (assuming the program is in the directory C:\VARGRADE): SET VMON=BW; SET PATH=C:\VARGRADE;%PATH%; GRADE If you have a monochrome monitor, you probably want to add that command to your AUTOEXEC.BAT file. This file is executed every time you start your computer. (d) Using one drive to run the program You can start the program from one 360K drive by putting the program disk in the drive, and typing "GRADE". When the program cannot find the overlay file, you will be asked to put the disk containing the file into a drive. If you now put it in the same drive that the program disk was in, the program will continue and run correctly. B. Picking a Class When the program starts, the first screen shows the program name, a comment about registering the program, the class files and directories listed on the directory from which the program was invoked, and a prompt for the class. If there are any files on the disk that have the extension ".PAR", they will be listed by the program on the opening screen. The ".PAR" file contains the parameters of your class: task names, default settings for the program, etc. To help you find the right class, sub-directories are also listed. You can either type in the name of the class, or you can use the cursor keys to locate the class. 1. Using the cursor keys One of the class files or a directory will be highlighted. If you have a monochrome monitor and do not see a class highlighted, try starting the program with "GRADE/B" to force the program into monochrome mode. To pick the correct class, use the cursor keys to move the highlight to the 30 Starting the Program correct class or directory. Then press <Rtn>. If you chose a directory, a new listing of classes will be shown. Repeat the above process until a class is chosen. NOTE: If any characters have been typed on the prompt line, the program will use them as the class name. You can delete these by using the <F10> key. 2. Typing in the name (a) If the class that you want is not listed, you can change directories and search for the class. There are two ways to change directories: i) Press <F5>, then type in the name of the new drive or directory. You can continue to change directories until you find the desired class. ii) Type the new drive or directory instead of the class name. The program first tests to determine whether what you have typed is a directory. If it is, the directory is changed. NOTE: The new directory must end in a backslash ("\"), or the new drive must end in a colon (":"). (b) If and when your class is listed, just type the name in. The ".PAR" is not needed, and any extensions, like .PAR, are discarded. The program will read in the class parameters, and, if a file with the same name with the extension ".DAT" is also there, the student scores will be read into the program. 3. Starting new classes Type in the name of the class. When the program does not find the ".PAR" file, it will creat a new class. Each class has two files. Each starts with the name of the class (e.g. "BIOLOGY"). They have the extensions ".PAR" and ".DAT" (e.g. "BIOLOGY.PAR" and "BIOLOGY.DAT"). There may also be backup files with the extensions ".PAX" and ".DAX" (see the Appendix for further details). 4. Using the DOS command line You may also enter the class name from the command line by listing it as a parameter: e.g. if the class name is "MATH", 31 start the program by typing: "GRADE MATH". If the class exists, it will be read into the program. If it does not, a new class will be created. C. Converting Old Classes Into New Classes If you want to use the same exams and class information for two different classes, just copy the "CLASSNAME.PAR" file to a new classname (e.g., copy "BIOLOGY.PAR" to the file "MATH.PAR" by typing, at the DOS prompt: "COPY BIOLOGY.PAR MATH.PAR". Math will now be set up exactly the same way as Biology). The new class is now set up the same as the previous class, except that no students will be in the new class. This feature can allow you to set up your class once and use the set-up for many classes in the future. D. Classes Too Big for the Memory After the classname is entered, the program will read in the class data and student information. If there are more students than can fit in the available memory, the program will warn you and ask if you want to continue. If you continue, the program will read ONLY as many students into the class as there is memory. WARNING: If you then use the program and save the data, the students that were not read into the program will be lost. To find out approximately how many students can be read into the program, enter a "Z" when in the Main Menu. At the top of the second menu you will see how many students are currently in the class and how many could be in the class if all the available memory is used and if the current tasks are not increased. There are essentially an unlimited number of students and tasks allowed. The limitations are that all the data must be able to fit into the available memory. Part of the program is in overlays. This means that part of the program is on disk, not in memory. When the program starts, it leaves a certain amount of memory free, and uses the rest for overlays. You can change how much of the program is in memory with a DOS SET command. If you need more memory, enter the following command at the DOS prompt: A> SET OMEM=0; 32 Starting the Program This command will shrink the program to its minimum size. Conversely, to put all the program into memory, use the command: A> SET OMEM=250000; You can add either SET command to your AUTOEXEC.BAT file that is executed when you start your computer. This way, the program will always use the amount of memory you want. You can vary the number from 0 to 250000 to get variable amounts of the program in memory. If you have more than 640K of memory installed in your computer, you may be able to use that extra memory as EMS memory. VAR Grade can use EMS memory for some parts of the program. If you are short of memory, this will let VAR Grade have more room for students and grades. E. Setting Up the Class Anytime that you want to change some of the current settings of the program, you can use the "Z" option on the Main Menu. 1. The number of sections The number of sections is initially set at 1 when you first start a new class. For example, if you teach 3 English classes that have identical exams and assignments, you can call them different sections of the same class. You can then compare the different classes as "sections". Each section uses the same set of exams, but the program can do statistics on any combination of sections. The program keeps track of what sections you last used, and will, by default, use whatever sections that were last used by you. To set the number of sections, go to the "Z" option of the Main Menu, then into "S". Just enter the number of sections that you have in the class. 2. Colors Yes, the colors of the program can be changed! This can be done in the "Z" option of the Main Menu, then "C". There are several colors used, designated: (i) Normal colors: The text is in this color. (ii) Background color: The background is this color. 33 (iii) Highlight color: Foreground color used for plotting scores. (iv) Highlight background: This color is the background corresponding to the highlight. (v) Error colors: Foreground color for error messages. (vi) Error background: This color is the background for the error messages. (vii) Help colors: Foreground color used by the Help screens. (viii) Help background: This color is the background for the help screens. Some of these colors are used in pop-up menus and messages, as well. To change the colors, press "Z" on the Main Menu, then "C" (color) on the second menu. You will be asked for the new colors. The bottom lines of the screen show what the colors would look like. Needless to say, if you are using a monochrome monitor, you will only see black and white colors. Some monochrome adapter boards tell the program that they are color boards. This results in some things becoming invisible or not highlighted when they should be. If this is the case for you, you can force VAR Grade into monochrome mode by either of two methods: (a) Start the program with "GRADE/B". The /B tells the program that you are using a black and white monitor. You can force the program into color mode with "/C" when starting VAR Grade. Example: C> GRADE /B GSAMPLE This will force the program into monochrome mode and load the data from the class GSample into the program. (b) Set a DOS command: "SET VMON=BW;". At the DOS prompt (e.g., "A>"), type the above statement. This tells the program you are using a black and white monitor. This command can also be put into your AUTOEXEC.BAT file that is run when your computer is turned on. After changing the colors, you are asked if you want to make these new colors the default colors. If you say "Y" (yes), all future classes will have the new colors as their initial colors. Lastly, the program keeps two sets of colors, one for monochrome monitors (black and white), the other for color monitors. This feature is for those who switch back and forth between color and monochrome monitors. 34 Starting the Program 3. Printers You can tell the program which printer you are using. In fact, to be able to print graphs and plots, you need to pick a printer during installation or in the "P" section of the "Z" option of the Main Menu. Virtually every printer is now supported by VAR Grade for printing graphs and plots. Most are also supported for printing files in pica, elite, or compressed printing (if your printer supports them), and bold and high quality. For unsupported printers, if you can find the codes in your printer manual, you can enter the necessary printer codes to support your printer (See Chapter X: Printing the Grades). 4. Passwords If many people have access to your computer and its disks, you may worry about someone's altering your class files. To greatly reduce the chances of this happening, you can require that a password be used for your class. To define a password, use the "W" option in the "Z" section of the Main Menu. NOTE: The default value is not to have a password. The password can have up to 15 characters, numbers, and/or punctuation characters. Should you forget your password, you can contact us at the address at the end of the manual to get instructions on how to defeat the password. The password is not foolproof, but greatly reduces the likelihood of snooping. F. Entering Students, Tasks, Attendance, and Grades There are two kinds of prompts in the program. The first, like the prompt asking for the classname, asks you to Enter the name and then type a <Rtn> to signify the end of the data. The second type only asks for one key--this option is usually used for the menu selections. To save keystrokes, the program will respond immediately when the key is pressed--no <Rtn> is necessary. When you are presented with a list of choices, you can use the cursor keys to move to the desired choice, then type <Rtn> to select that choice. NOTE: In many parts of the program, if you enter a <Rtn> with no data entered, the program will assume either that: (a) you did not want to enter data--the program will continue; or (b) you want to exit this section and go back to a higher level menu; or (c) the number to be entered is zero. 35 In general, if the program asks you to enter data, you should end with a <Rtn>. If you are choosing a menu option or between two alternatives, press only the appropriate key. When you have to enter a long list of numbers, such as designating Task 80 as the sum of Tasks 1 to 79, the program will allow you to enter them with an inclusive colon: "1:79" would be 1 through 79, rather than requiring you to enter all the numbers from 1 to 79. This situation arises in three places: when entering lists of tasks, as noted in the example, when entering lists of sections to use, and when entering attendance days. Colons can be used to enter a list of numbers from high to low, as well. Entering "79:1" will tell the program to use tasks 79 down to 1. Example: To enter tasks 1 thru 5 and 8, type: "1:5<Rtn>8<Rtn><Rtn>". NOTE: When entering a list of separate numbers, you can separate them with <Rtn>s, commas, or spaces. For the above example, typing "1:5,8,<Rtn>" or "1:5 8 <Rtn>" will give the same result as the example above. Later chapters in this Manual will tell you how to enter students, tasks, attendance, and grades. G. Reading the Manual and Help screens If the files GRADE.HLP and/or GRADE.MAN are present in the default directory of any drive or in any directory specified by the DOS path command, then you can read them from the program (See Chapter V Section A, above). When the program is on the Main Menu, type an "H" for help or an "M" for the manual. The help screen is much shorter and less detailed than this manual. The help screen can also be reached from anywhere in the program by typing <AltH> (press the ("Alt" and the "H" keys simultaneously). The help reached from <AltH> is context sensitive. This means that VAR Grade will try to find the relevant material from the help file. You can browse at will through the file by using the cursor keys. When in Help or the Manual, typing <AltK> will show you a list of the keys and features supported. If there is not enough memory to display the file, an error message will appear. To view the file, you would then have to reduce memory use (See Section D, above). 36 Starting the Program Moving with the keys in HELP or the MANUAL: Key Movement <Up Arrow> Up one line <Down Arrow> Down one line <Page Up> Up one screen <Page Down> Down one screen <Ctrl-Home> Up one-half screen <Ctrl-End> Down one-half screen <Home>, <Ctrl-Pg Up> Beginning of the file <End>, <Ctrl-Pg Down> End of the file <AltL> GO TO LINE: The top line will be the line that you designate. In the center of the screen a box will appear that will ask for the line number. At the bottom right of the screen, you can see which line you are on and how many lines there are in the file. Example: type "<AltL>4<Rtn>" to go to line 4. <AltP> GO TO PAGE: Moves to a page in a file, assuming 56 lines per page (as in the manual). In the center of the screen a box will appear that will ask for the screen. Example: type "<AltS>22<Rtn>" to go to page 22. <AltS> GO TO SCREEN: The top line will be the first line of any screen that you enter. In the center of the screen a box will appear that will ask for the screen. The total number of screens and the screen that you are currently on are shown at the bottom right corner of the screen. Example: type "<AltS>8<Rtn>" to go to screen 8. To locate text: Key Movement <AltF> Find a string <AltN> Find the next matching string <AltB> Find the previous matching string <AltK> Show the supported keys <AltJ> Jump to the previous screen 37 VI. ENTERING STUDENTS One of the first things that you will do when starting a new class is to enter the names of students into the program. This Chapter tells you how to enter new students into the class, add IDs, change the names of students, and sort and list the students in the class. A. General Methods When the Main Menu is on the screen, choose the "N" (Name) option. Several options will be listed on a new menu, the Add Student Menu. You can type the names into the program via options Name only ("N"), or by Name and ID ("I"). You can import (read) names into the class from flat files ("F" and "A"), or comma and quote files ("C"). B. Names and IDs The student names can be up to 20 characters long, and can include spaces and punctuation. The program can sort the students alphabetically by their names for printing out scores, so it is usually better to enter the names last name first. Spelling is retained exactly as you enter it, except that leading and trailing spaces are ignored. When sorting, however, lower and upper case letters are not distinguished, so "Sue" is considered to be the same as "sue". ID numbers or other names (nicknames, etc.) can be entered as "IDs". At some colleges and universities, students are given their grades by student numbers rather than by name. You can use IDs for first or last names and the "name" for the last or first name. You can change IDs, or add them later in the several sections of the program. IDs can be up to 15 characters long, and can include spaces and punctuation. The program can sort by IDs as well as names. Spelling is retained, but, as in sorting names, sorts do not distinguish between lower and upper case letters. 38 Entering Students C. Typing in Names and IDs 1. Names only You add names on the "N" option on the Add Students Menu. You first need to tell the class which section you want to enter students. Pick a number from 1 to 254. To enter names, you just need to type in the name, ending with a <Rtn>. If the name is already present in the section, it is NOT reentered and an error message results. The same name can be used in two different sections of the same class. To delete the letters you have typed, and hence remove the name, type an <F10>. The <F10> command works in all parts of the program. Names can be changed later in several parts of the program (see below). If you added the previous name in error, you can use the cursor keys to move to it. When you have added all the names, press <AltS>. You will exit back to where you are asked for the section numbers again. To exit, press <Esc>. 2. Names and IDs This option, "I" on the Add Students Menu, works the same as for adding names only. The only difference is that you are asked for the ID, as well. Leaving a name or ID blank will remove it. 3. Adding, changing, and deleting names, IDs, and notes Names, IDs, and notes can also be added, changed, or deleted in four other places of the program. The details are described in later chapters. The four places are: (i) "I" on the Main Menu: Individual students; (ii) "D" on the Main Menu: Data entry for tasks of the class; (iii) "A" on the Main Menu, then "I": Adding attendance for individual students; and (iv) "A" on the Main Menu, then "C": Data entry for class attendance. Student notes are a field in the student records that can be used to enter up to 20 characters. Notes can be used to enter seating arrangements, comments, nicknames, or anything else you may want. They can be printed, but otherwise are not used much by VAR Grade. They can be entered and changed in the same four places of the program mentioned above. 39 (a) When individuals are listed In the attendance by individual students (iii, above) or Tasks by individual students (i, above), all the tasks or attendance for a student are listed. If you press the <AltI> key (insert student), you will be presented with a blank form to enter the new name. Entering any letters will add the student to the class. An "Empty" or blank name will be deleted or not entered into the class, and the deletion can be quickly done by using the <F10> key. NOTE: when a student has been deleted, his or her name and all associated data are deleted. Changing the spelling of the name, ID, or note, or changing the section number for the student, is also possible here. NOTE: only sections that have been defined are allowed as sections for the student. You can increase the number of sections in the "Z" section of the program. (b) When the whole class is displayed If you need to add a new name when in parts ii or iv (above), use the key <AltI>. A new line will be displayed on the screen. As above, removing a student name will remove that student and the associated data from the class. Blank names are removed from the class only when you leave that section of the program. A second way to delete the student is with the <AltD> key. The student will be deleted immediately, and the rest of the class moved up one line. NOTE: when a student has been deleted, his or her name and all associated data are deleted. You can also change the names, IDs, notes, or sections for a student by using the cursor keys or a mouse to move to the cell with the name, ID or section and typing in the new name or ID for that student. To see any students not listed on the screen, use the cursor or Alt keys (as listed at the top of the screen). The cell highlighted is the one that will be used for data input. You can use the <F10> key to completely delete the ID or name. 40 Entering Students If you start altering the data, then decide the original data was correct, you can retrieve the data if you haven't moved from that cell. Use the <AltU> (undo) key to get the original data back. (c) Recovering deleted data Data that has been changed or deleted is normally lost. There are, however, two ways to recover the data if you immediately decide to "undelete" it: (i) quit the program without saving the data to disk. Any data entered in this session will not be saved. (ii) if you have already saved the data from the class, use the backup files to recover the data from the previous session. More information on how to do this is located in the Appendix. (d) Removing groups of students The Add Students Menu ("N" on the Main Menu) has two options that can be used to remove groups of students. You can remove all students from any section, or you can delete all students from the class. Be careful when you use these options, as all the data for the students that were removed is lost. D. Importing Students from Files You can also enter names via text files. VAR Grade will import data that is written by many other programs, including most spreadsheet programs. When data is imported into VAR Grade, either a student name or an ID must be included for each line. If a student name is included, the program will check whether the name is already present (as well as whether the section is correct, if used). If the name is present, the data will included with that students' data. If the name is not present, the program will add a new student. If you do not include a name on each line, the program will check the ID to see if it matches a student in the class. If so, the new data will be added. Otherwise, all of the data will be discarded. If a student name and ID is included, the name will be checked. If the student exists, the ID will be changed to the new ID. For student notes, if new notes are included, they will replace the old student notes. 41 For tasks, the program will try to match the task number or task name. If it matches either as being identical to a task already defined, the new data will be entered into that task. Otherwise, a new task will be defined and added to the class. For those tasks, the new data will replace the old data. 1. Importing flat files Many spreadsheets will export (write) data in a flat file. A flat file is one where the data is listed in columns. All the names of students are in one column, all the IDs in another, etc. In the "F" option of the Add Students Menu, you can pick a flat file of student names, IDs, sections, and/or task scores, tell VAR Grade which columns the name, IDs, sections, and tasks are in, and have the data automatically loaded into the class. The file must have been previously prepared by deleting lines that do not have student names on them, or else the program will try to load those lines as well. An example of a flat file is listed below: Jones, Fred 123 1 34.5 23.5 B 44 Smith, Ann 321 2 43.5 18.3 B 43 To load new students into the class, the program will first ask for the filename of the flat file. It will then display the contents of the file across the top of the screen, along with a ruler. You now have to tell the program what data is where. First, you need to tell the program where the student names are. An answer of 0 tells the program that data is missing from the file. Next you tell the program where the IDs, notes, sections, and tasks are located. For the tasks, you will also be asked for the number of the task. Data then will be read into the program. For the tasks, if the data is numeric, it will be read in as number tasks; if it is not numeric, the data will be read in as letter tasks. In the above example, suppose the first column is the names, the second the IDs, the third the sections, and the next four are tasks. The sixth column (third task) would be read in as a letter task. The tasks would be numbered as the first four unused tasks in your class, and given names (e.g., Number task 1, Number task 2, Letter task 3, and Number task 4). 2. Importing comma & quote files Many spreadsheets also can read in data from files where the data is not in columns, but is instead separated by commas. 42 Entering Students Data that has commas in it, e.g., student names, are kept together by double quotes (""). The "C" option of the Add Students Menu lets you import data from these files. An example of data in the file might be: "Jones, Fred", "123", 1, 34.5, 23.5, B, 44 "Smith, Ann", "321", 2, 43.5, 18.3, B, 43 The program will assume that the student names are in the first field, the IDs in the next, and the next five are tasks. For the tasks, the fourth one will be a letter task; the others will be number tasks. As in the flat files, the names of the exams will be made by the program, and the first five unused tasks will be used for the new tasks. If this is not what you want, you have another option. You might include this as the first line of the file: "Name", "ID", "Section", "One", "Two", 8, "#4" This line would tell the program that the first field is the name, the second is the ID, the third is the section, the fourth and fifth are number tasks (they are numbers) with the names One and Two, the sixth is a Letter task 8, and the last field is a number task with the name #4. NOTE: Whether they are letter or number tasks is determined by the student data, not from the first line. On the first line, "Name" tells the program that field is student names, "ID" tells it is IDs, "Notes" means student notes, "Section" refers to sections, and any other words are treated as tasks. These need to be the entire label for the fields, but whether the labels are in upper and/or lower case letters is not important. For the tasks, anything that is a number (like 8) is taken as the desired number of the task (the program will make up a name for the task), and anything that is not a number will be taken as the name (with its number being the first unused task). Whether the tasks are made number or letter tasks are determined by the data on line two (the first student). 3. Automatic flat file imports The "A" option on the Add Students Menu works like the previous one ("C"), except that the fields are separated by one or more spaces, not by commas. The method of determining the type of data is the same as that used for the comma and quote files. 43 4. Entering scores of one task The "G" option on the Add Students Menu is designed to be a simple import of grades from one task. The main purpose of this option is for instructors in large classes. They can easily import grades on an assignment from their teaching assistants. Either names or ID's are matched with students in the class, then the new grade will replace the previous one. The files imported need to have either the name or ID listed first, then a comma, then the task scores. If the names have commas in them, you can surround them with double quotes (e.g., "Darwin, Charles"). When you enter this part of the program, you are asked for the file name, the task number, and whether to match names or ID's. If the teaching assistants use VAR Grade, it is easier to export and import via a comma and quote file, as the import is done automatically. The file format should have names or ID's like the following example (listing ID's, then the task score): A1234567, 66 Z6543210, 44 5. GrUtil The utility program GrUtil can load students from text files into the class via all three ways as VAR Grade can. It will also print "grids" for the students. Grids are empty boxes for entering data. There are, therefore, four different things GrUtil can do. For the examples below, the DOS prompt is assumed to be "A>", although your prompt may be "B>", "C>", "C\VARGRADE>", or any other prompt. It is also assumed that you are reading students into the class GSAMPLE. If you have a monochrome monitor, you can start the program with an extra "/B", e.g., start with GRUTIL/B instead of GRUTIL for the examples below. 44 Entering Students (a) Printing grids To print grids, you need to tell the program what class to use, and that it needs to print grids. To print grids of the class GSAMPLE, type, at the DOS prompt: A> GRUTIL GSAMPLE GRID Be sure your printer is on when you run this program. This is a quick way to get a list of the students and to get boxes to put their grades. You can print attendance grids (twice as many boxes) by replacing "GRID" with "AGRID". (b) Loading students from flat files GrUtil can load students from flat files, the same as VAR Grade, but you must specify the columns for the names, IDs, and sections when you invoke the program. If the column for the student names starts or ends with a 0, the program assumes that it should figure out what data is where, and loads as do the comma and quote files (see below). If there are no IDs or sections, then entering a 0 for the start of their data will cause the program to not load them into the class. For example, to load from the flat file FLAT.TXT into the class GSAMPLE, type the following at the DOS prompt type (the numbers are the names, etc): A> GRUTIL GSAMPLE FLAT.TXT 1 20 21 40 0 0 41 44 This will tell the program to load students from the FLAT.TXT file into GSAMPLE, with the names starting at column 1 and ending at column 20, the IDs starting at column 21 and ending at column 40, and the sections at column 41 and ending at column 44. Student notes are not in the file. If you are just loading names into the program, type: A> GRUTIL GSAMPLE FLAT.TXT 1 20 (c) Loading students from comma and quote files Students from comma and quote files will be read by GrUtil the same way that VAR Grade does. Type, at the DOS prompt: 45 A> GRUTIL GSAMPLE COMMA.TXT COMMA This tell GrUtil to load students into the class GSAMPLE from the file COMMA.TXT. COMMA tells the program it is a comma and quote file. (d) Loading students from other files If you start GrUtil with only the names of the class and a text file, or with those plus a 0 for the where the student names start, GrUtil will assume you are loading a flat file. It will try to make sense of the file in the same manner as the quote and comma files, except that spaces separate the cells. To load students this way: A> GRUTIL GSAMPLE TEXT.TXT See the section "Automatic Flat file Imports" above for more details. 6. Large classes (a) Transferring scores between classes For classes with many sections, teaching assistants usually grade the sections. You can have them export grades from their section as a comma and quote file, then import them into the program (again as a comma and quote file). To do this, you need to make sure that (a) the section numbers are exported along with the grades, and that (b) the task (exam) names that the teaching assistants use are all identical. So, for example, they must all use "Midterm #1" and not "Exam #1" or "Midterm 1", etc. Other ways to export and import scores are suggested above. (b) Moving students between sections You can move all the students from one section to another one by pressing "M" on the Add Students Menu. You will need to enter the old and new section numbers. Every student in the old section will be moved into the new section. 46 Entering Students (c) Deleting Sections You can remove one or more sections of a class by pressing "N" on the Main Menu, then "S". Every student in the section or sections that you choose will be removed from the class. All student in the class can also be deleted from this menu. E. Sorting Students Students can be sorted by a variety of methods, including by name only, by name and section, by ID only, by ID and section, by section only, by the scores of any defined task, or by no sorts. You can change the method of sorting in the "Z" option of the Main Menu, then "A" (alter the method of sorting the class). The change is "permanent" in that the program will remember which sorting method was used and will continue to use that method until told differently. Sorts are not done until you are finished altering data, so if you add new students, the names will not be alphabetized or sorted until you exit back to the Main Menu. You can have the program list the students via their names OR by their IDs. This affects how the students are listed when you see lists of students on the screen. When you print the scores, you are also asked how you want the class listed to the printer. F. Transferring Names to a New Class If you have entered names into one class, and need to have the same list of students entered into a second class, there are several ways it can be done. First, if no tasks have been entered, you can simply save the names of the first class, then save them again with a different name. Saving is done in the "S" option of the Main Menu. When you save the class, it first lists the name of the class. Just change it to the second class name. WARNING: When you change the name of the class, the program assumes that the new name is the one you are using. So if the first class was English, and the second Physics, the program will use the Physics name for the class currently in memory. 47 Second, if tasks have been entered, you can do the same procedure as the first one, except that you then remove all the tasks from the second class. This is done on the "T" option of the Main Menu, then "R". Third, you can export the class names as either a comma and quote file or as a flat file. Then you can read the names back in to the new class. Example: When in English, save the class as a flat file in the "W" option of the Main Menu. Then exit the class ("X" on the Main Menu), and choose the Physics class. Then, in the "N" option of the Main Menu, tell the program to import a flat file, and choose the one you just wrote. 48 Defining Tasks VII. DEFINING TASKS Tasks are graded assignments for students. They can be homework, exams, tests, papers, or anything else that is graded. There are ten different predefined types of tasks in VAR Grade. The tasks are divided into two categories: (1) Regular tasks are those where you enter grades. There are three types of regular tasks. (2) Special tasks are those that you do not enter grades into. These include sums, averages, percentages, etc. There are seven types of special tasks. Defining, removing, and redefining tasks can be done from the Task Type Menu, the "T" option of the Main Menu. A. Regular Tasks You can enter tasks as numbers (Number tasks), you can enter them as letters (Letter tasks), or you can enter them as extra credit (Extra credit tasks). These can be defined in the "T" section of the Main Menu. You give a task a name, then, if it is a number task, the total allowed points for that task. 1. Number tasks Number tasks are ones in which you enter numbers as the grades. The maximum allowed points for any regular task is one million! The program checks the scores of every student when you put in the scores to make sure they do not exceed the maximum allowed points. If the score does exceed it, that score is rejected, and a new score must be entered. This validation of scores reduces the number of errors made while entering student scores. Tasks that have 0 or less total points are ignored by Special tasks. Note that the program will assume the task has 100 total points unless you alter the number. You can also "fast define" a sum task by pressing <F1>. The next available task number will be defined as a Number Task having 100 points. All you need to enter is the name of the task. The next available task number means that if you have defined tasks 1 through 10, the new one will be 11. If you have defined tasks 1 thru 5 and 10 thru 15, the new one will be task 6 (not 16). 49 If you decide to increase or decrease the total points of a number task, you can do so without changing the student scores. You need to redefine the task. For example, if task 5 is worth 50 points, and you want to change this to 100, you define task 5 by pressing "N" on the Task Menu. You will be asked for the name of the task (with the old name shown). You will then be asked for the total points (enter 100). Last, you will be asked if the student scores should be deleted. At this point, say NO. The new total points will be 100, and the student scores will be the same. WARNING: If you decrease the total points, student scores greater than the new total will be reduced to that total. 2. Letter tasks Letter tasks are ones where the scores are entered as letters. The program will converts them to numbers, but the score can be entered, printed, and manipulated as a letter grade. The standard or default grading system is an A is 4.0, a B is 3.0, a C is 2.0, etc. Plusses are 0.3 points higher (except A+), and minuses are 0.3 points below the grade (e.g. B- = 2.7; C+ = 2.3). You can, however, define any grading system that you want, including the names and points for each grade, as long as the total grade types does not exceed 50 (see Chapter XI, Section ). If you do change the grading system, you should do it before you enter any letter grades. The program stores the grades as numbers, not as letters. Thus, changing the points allowed for letter grades after some letter grades have been assigned can result in incorrect scores. 3. Extra credit tasks Extra credit tasks are ones where the points can be added to a number task, but the total points of the number task are not altered. Extra credit tasks are treated in special ways by the program. The extra credit tasks need to have the total points be specified, just like number tasks. However, this number is used only to check data entry. As far as the special exams (below) are concerned, extra credit tasks have 0 total task points, but the student scores are used in the calculations for special tasks. In the case of discarding the lowest of a list of tasks, if the extra credit score is one of lowest scores, it will be discarded. This may not be 50 Defining Tasks what you want, so you should consider this potential problem before you include extra credit tasks in the definitions of Highest Tasks. B. Special Tasks The second type of tasks are called Special tasks. These can also be specified in the "T" section of the Main Menu. Special tasks are Sums, Averages, Highest, Percentages, etc., of other tasks. You do not enter scores into special tasks. Instead, you define the task as the sum (average, percentage, highest, etc.) of other tasks. The program then calculates the scores for you. These scores will be recalculated each time you change student scores. Note: Unentered tasks can either be ignored by special exams or they can count as 0 total points. Which of these the program will use can be set on the Grading Menu ("G" on the Main Menu, then "Z"). Scores less than the fewest allowed points, which can also be set on the Grading Menu, will always be ignored. For example: at the end of the term, you probably want to add up all the task scores in the class. You can specify a task, e.g. #30, as the sum of all the previous tasks (#1 through #29). Task #30 is a special task called a "sum task". Since any of the 10,000 possible task numbers can be either a special or regular task, you can, for example, define special tasks as the sums of quizzes, tests, and/or homework. One limitation for defining special tasks is that they can be defined only as tasks acting on other tasks with lower numbers. Allowing you to add or sum tasks with the same or higher numbers could result in circular definitions that would confuse the computer and produce nonsense or variable results. A second limitation applies only to sums of tasks. The total points allowed for a "sum task" (like task #30 above), is 9,999,999 (less than 10 million points). The ability to specify any task as the sums of others is a very powerful feature that should allow great flexibility when you analyze student scores. NOTE: Tasks can be removed by using the "R" (remove) option on this second menu or by redefining the task as a new task. To remove, choose the "R" (Remove) option. Then choose the task number or numbers at the prompt. Since all student data for the task(s) is also removed, you will be asked again to make sure that you want to remove the task(s). 51 1. Sum tasks These are tasks that are the sums of other tasks. Tasks can be summed multiple times. Example: Task 5 can be the sum of task 1 + task 1 + task 1. This would be the equivalent of multiplying the task by 3. Tasks that are not yet entered can be included in the list of tasks that will be summed. When the tasks are then defined, they will be included in the sums. The total points possible for each student includes only those tasks that have scores entered. Example: Task 12 is the sum of tasks 3, 5, and 7. Each has 100 possible points. Mary had 90 points on task 3, and 85 on task 5. She has 175 of 200 points. When her score for task 7 is entered, there will then be 300 total points possible. NOTE: The sums of all the tasks in a Sum task must be less than 10 million points. 2. Averaged tasks These are tasks that are the average of other tasks. Task 5 can be the average of tasks 1 through 4. If you use letter grades, the averages are reported as scores between the highest (e.g. A) and the lowest tasks (e.g., F), but the average is shown with numbers, not letters. Any tasks that have not yet been entered are NOT averaged, so the averages reflect only those tasks for which the student has had scores entered. 3. Percentage tasks These are tasks that average other tasks, then convert the scores to percentages of the total points. Example: If task 10 is the percentage of tasks 5 and 6 (which each have 100 points), the program adds up the scores from 5 and 6, then divides the scores by the total points of 5 and 6 (200 points). The score is then converted to a percent by multiplying by 100. Hence, the scores range from 0 to 100 percent. Like sum and average tasks, any tasks that have not yet been entered are not used in the conversions, so the percentages 52 Defining Tasks reported for the students are for the tasks that have already had scores entered. 4. Highest tasks: Throwing out the lowest scores Throwing out low tasks seems to be a popular phenomenon with students. Unfortunately, it is a fairly tedious thing to do for instructors. You can throw out the lowest of a set of tasks in VAR Grade. In the "T" section of the Main Menu, option "H" will allow you to define a task that will throw out the lowest task(s) of a special task. Example: You can throw out the lowest two out of ten tasks. Highest tasks discard the lowest one or more scores of a sum, average, or percentage tasks ("throw out the lowest of several scores"). The special task that is used must have a number lower than the highest task. This is a very common grading option that is used in many classrooms. For a highest task, the program will find the lowest scores of a list of tasks and add up only the highest of those scores. You need to tell the program how many tasks to discard (the lowest 1, the lowest 5, etc.). Scores that are unentered are discarded first, then the lowest scores that have been entered are discarded. You can throw out scores on any sum, average, or percentage task. The "highest" task will report the score with the same type. Therefore, if you discard the lowest of an average task, the scores will be reported as an average. 5. Weighted tasks You can define a task as the sum of other tasks, each times a weight. For example, you can define task 20 as the sum of task 10 with a weight of 0.2, task 11 with a weight of 0.3, and task 12 with a weight of 0.5. This will give "true" weighting of tasks. Unentered tasks are always given a score of 0 for the weighting. You will first be asked for the total points the task will be worth, after weighting. Then, you will be asked which tasks to weight. Last, you will be asked for the relative weights for each of those tasks. The relative weights can be percentages, or in arbitrary numbers. Example: If you have three exams in your class, each worth 100 points, and want to weight them 30%, 30%, and 40%, you 53 can define task 4 as the weight of task 1 with a final weight of 30, task 2 with a weight of 30, and task 3 with a weight of 40. The calculation for the weights is done by taking the weights you give for each task and dividing them by the total points for each task. These numbers are then added up and adjusted so that the maximum possible points is equal to the total points of the weight task. For the example above, assuming you want the total points to be 100, the students scores are calculated as: 100 * (((Task #1 score) * 30 / 100) + ((Task #2 score) * 30 / 100) + ((Task #3 score) * 40 / 100)) The parentheses denote calculations that are kept together. In the example, "*" means "multiplied by". 6. Final task You can define a task as a final task. This task will assign letter grades based upon scores of another task. These scores are only assigned after cutoffs have been assigned. This is done either by defining automatic cutoffs in the "G" option of the program before you define the task, or by assigning new cutoffs, also in the "G" option. The final grades are recalculated each time new scores are entered. If you don't want the grades recalculated, you can either change the task to a letter task after the assignments, or you can transfer the scores to a new letter task. 7. Attendance task If you use attendance in your classes, you can define a task that will automatically calculate a score based upon their attendance. To do this, you first specify how many points the task will be worth. Next, you need to pick which attendance days to use. Note that pressing <F1> will choose all the attendance days. Last, you can assign relative weights for each type of attendance (there are six different types), and how many days to ignore (for example, if you allow two absences per grading period, you can tell the program to discard the lowest two attendance scores). For assigning the relative weights for the different types of attendance, you can assign "default" values on the Attendance Menu ("A" on the Main Menu). 54 Defining Tasks NOTE: If there are other types of special tasks that you would like to have the option of using, send a note to us and explain how this type of task would be calculated. We will try to accommodate you. C. Scaling Tasks In the "G" option of the Main Menu, there is an option that lets you add any number of points to a regular task, or multiply the scores of any regular task by a number. Since the primary purpose of scaling scores is to adjust the scores before giving final grades, further details are given in Chapter XI, Assigning and Printing the Final Grades. D. Memory Limitations Each task that is defined takes up space. In cases where memory is limited, you may find that you cannot define a new task. You may need to delete an old task to be able to add a new one. A second option to increase your memory is by removing any TSR (terminate and stay resident) programs like SidekickTM (Borland International) from memory BEFORE running the program. A third option is to tell VAR Grade to use less memory for overlays (See Chapter V, Section B3, above). VAR Grade uses very little memory per student, so, for example, classes of 30 students with 30 tasks or of 90 students and 10 tasks would take up less than 15K of memory over and above that used by the program. If you are having memory problems, contact us at the address below for possible solutions. E. Manipulating Tasks Tasks can easily be moved, copied, removed, and so forth. 1. Copying tasks Tasks may by copied to new tasks that have higher task numbers. To do this, go the "T" option of the Main Menu, then press "C". The definition of the task is copied exactly, even if the task is a special task. The students scores are copied as well. You will be asked for a new name for the task, however. 55 Example: If the task to be copied is a number task, the new task will have the same total points and student scores as the first task. Example: If the task to be copied is defined as the percentage of tasks 1 through 3, the new task will also be defined as the percentage of tasks 1 through 3. 2. Transferring tasks When tasks are transferred, the student scores are transferred but the task definition is not. The task to transfer to is defined as a number or letter task, depending upon the definition of the task to be transferred. The student scores are copied from the first task to the second. 3. Transfer one task definition You can transfer the definition of a single task, but not any student scores (which will be set as not yet entered). It is equivalent to copying the task, then clearing all the student scores. 4. Transfer a group of task definitions You can also transfer the definitions of a group of tasks. The group is specified be entering the beginning and ending numbers of the tasks, then specifying where to transfer them. Like the previous option, the task definitions will be transferred, but no student scores will be transferred. If any of the tasks that are transferred are special tasks, their definitions will be adjusted as follows: if the special tasks include any tasks that are also transferred, the new tasks will be redefined to include those tasks rather than the original tasks. Example: Task 6, Week 1 average, is the average of tasks 1 through 5 (Monday thru Friday grades). You decide to transfer the definitions for Week 2. You transfer tasks 1 thru 6 to 11 through 16. Task 16 will now be defined as the average of tasks 11 through 15 (not 1 through 5). 5. Moving tasks You can move one or more tasks. To move one task, press "M" on the Task Type Menu. To move a group of several consecutive tasks, press "G". When a task is moved, the task is renumbered, and all the special tasks that use that 56 Defining Tasks task are redefined to refer to the new number, as well. When you move a group of tasks, you are asked for the first and last numbers of the tasks to move. All the tasks between and including those two numbers are moved. Student scores, of course, move along with the task. 6. Clearing student scores To redefine all student scores for a task as unentered, use the "K" option on the Task Type Menu. The task remains defined the same way as previously. You can clear only regular tasks, as the others are recalculated each time scores are entered into the class. 7. Show task definition To help you remember how you have defined tasks, the "V" option on the Task Type Menu will list the current definition of the task. 8. Removing tasks You can remove one or more tasks from the class. The "R" option on the Task Type Menu asks you for a list of all the tasks to remove. After you specify the tasks to be removed, the program will ask you if you really want to remove them. If you say "D" (delete), the task and the student scores will be deleted from the class. Using the option with the <F1> key to select all tasks will start the class over for you. If you have the same students from one grading period to the next, removing all the tasks will start the class over for you, while keeping the students in the class. F. Examples of Task Definitions Example #1: I gave three tests. The first was worth 100 points, the second was worth 130 points, and the third was worth 211 points. I want the exams to be worth 25%, 25%, and 50%, respectively, and the total points to be 100. Solution: Define the tests as Tasks 1 through 3, all number tasks. Define task 4 as a Weight Task. For task 4, make the task worth 100 points. Then pick tasks 1 through 3, and assign task 1 a weight of 25, task 2 a weight of 25, and task 3 a weight of 50. 57 Example #2: For each test, I give two versions to my students. Half the students take one version, half the other. I want to keep track of each version separately, yet calculate the final averages in the semester for the students in my class. Solution: For each test, define three tasks. The first two are the two versions of the tests. The third one is an Average Task, which averages the first two tasks. The third task will be the average of one task that has an entered score and one that is unentered, hence equivalent to the entered score (see the definition of Average Tasks, above). Example #3: I give a homework assignment, then give students extra credit for turning it in early. At the end of the semester, I discard the lowest homework assignment. However, I don't want the extra credit discarded, just the lowest homework. Solution: When the homework is graded, define the homework task, the extra credit task, and a third task, the sum of the homework and extra credit. When you discard the lowest homework assignment, use the third task in the definition, not the first two tasks. Example #4: I want to distinguish between unentered grades and excused grades. How do I do it? Solution: The program keeps track of the lowest allowed score. When the program is first run, the lowest allowed score is 0. You can, however, enter scores less than 0. You can always enter scores down to -1,000,000. NOTE: You can tell the program the lowest score to use for statistics in the "G" option on the Main Menu, then "F" for fewest. The program, when calculating statistics, assumes that scores less than the fewest allowed points are unentered scores. The scores you entered, however, are displayed correctly (as scores less than the fewest allowed) when printing or entering scores. Hence, if you enter a -100, it will be ignored for the plots, printing, etc., but written as a -100 when entering data. Example #5: I want to assign grades to students halfway through the semester. I then want to assign final grades at the end of the semester. Solution: Define a Final Task at the half way point that assigns grades based on the first half scores. Then assign grades in the "G" option of the Main Menu. Define a second Final Task that assigns grades based on the grades for the entire class. 58 Defining Tasks Example #6: I defined a number task as having 100 points. I entered grades, then decided to redefine it as having 110 points. Yet, I do not want to lose the previously entered grades. Solution: When you redefine a task, the program asks whether to delete any previous grades. If you say no, the grades will not be changed. The only exception is if you decrease the number of points, and a student has more than that number. That student score will be decreased to the new maximum points for the task. Example #7: I give three quizzes each week. Then I define a task as the sum of these three scores. It's tedious to keep defining the tasks each week. Is there an easier way? Solution: Define the tasks for the first week. Thereafter, transfer the task definitions (section E4, above). If the first week tasks were 1 through 4, transfer the group to tasks 5 through 8. The new task 5 through 7 definitions will be the same as tasks 1 through 3, and task 8 will sum tasks 5 through 7. Example #8: Halfway through the semester, I like to give the students a handout that tells them their current grades, including a tentative final grade. Solution: Define a task that sums, averages, or calculates the percentages of the scores on the tasks. Define the automatic cutoffs in the "G" option of the Main Menu. Use your standard grade cutoffs. Then define a final task, using the previous task. This task will now calculate final grades based upon only those scores that have been entered. Example #9: I set up my class so that tasks 1 through 10 are quizzes, 11 through 20 are tests, and 21 through 40 are homework. I just gave my eleventh quiz. What do I do? Solution: Move tasks 11 through 40 to higher numbers. For example, move them to tasks 21 through 50. This is done with the "M" option on the Task Menu (see section E5, above). Example #10: I gave three exams, each worth 100 points. However, the third exam should have been worth 150 points. How can I fix this? Solution: Scale the task, "S" on the Grading Menu, by telling the program to multiply the scores by 1.5. The new scores will each be 1.5 the original scores, and the exam total points will be 150. 59 Example #11: I used one class for the fall semester ("Fall"), and another for the spring semester ("Spring"). I want to consolidate the grades from the two classes so that I can calculate a final grade for the year. How can I do this? Solution: One way is to define a third class, "Year". Enter and export, via a comma and quote file ("W" on the Main Menu, then "Q"), the task scores you need for the final grades from each of the two classes "Fall" and "Spring". Make sure, before you export the tasks, that the names of the tasks from the two classes are different. Then, when in "Year", import those two files ("N" on the Main Menu, then "C"). Example #12: I want attendance to count for 20% of the grade in my class, tests 40%, and homework 40%. In addition, I allow three absences in the semester. How do I do this? Solution: First, define a task that totals the homework (e.g., #20), and one that totals the tests (#21). Nest, define an attandance task (#22). Make the task worth, for example, 100 points. Pick which days to use for the attendance. Then, specify three days of attendance to be discarded. Last, assign weights for each attendance type (e.g., 2.0 for present and excused, 1.0 for late, and 0 for the rest). Next, define tasks that total the homework and tests. Last, define a weight task (#30), and assign the attendance task (#22) a weight of 20, homework (#20) a weight of 40, and tests (#21) a total of 40. If you want final grades assigned, define a final task that uses the scores of the weight task (#30). Whew! 60 Entering Grades VIII. ENTERING GRADES Grades can be entered into the program in either of two ways. Either the whole class can be listed for a list of tasks, the "D" option of the Main Menu, or every grade for an individual student can be listed, the "I" option on the Main Menu. A. Entering Data for the Whole Class The "D" option of the Main Menu lets you enter task data for all students in the class. 1. Moving around the screen Students, IDs, sections, and tasks can be listed on the screen. To enter scores, the tasks must have already been defined in the "T" option on the Main Menu. Only number, letter, and extra credit tasks can have scores entered. The others are calculated by VAR Grade. To change which data is listed on the screen, use the key <AltC>. You will be asked (a) if you want to list the students by name, ID, or both; if you pick both, there will be one column for each on the screen. (b) Next, if there is more than one section of students in the class, you will be asked if you want the sections to be listed. (c) Next, you will be asked if student notes should be listed. (d) Finally, you can pick which tasks are listed on the screen. The options you select are saved by the program, so that the next time you use the program, the same list is shown. Any time you define a regular task, it will be added to the end of the list of tasks. Only the first characters of the task name (how many depends upon the total points for the task), as well as its number, are listed at the top of the columns, while the student names, and/or IDs, notes, and sections are listed on the left. A cell is a piece of data. It can be a task score, a name, etc. To move between cells, use the cursor keys. The cursor keys are the ones on the keypad, including the arrows and the home, end, etc. keys. If you "use" cursor keys, then use <Ctrl>-cursor keys to move between cells. Otherwise, use the left, right, etc. keys to move between 61 the cells. You can change between "using" and not using cursor keys for editing by pressing <Ctrl-E> at any time. If you move past the right end of the screen, the tasks are scrolled to the left. The student names (or IDs), however, always stay listed on the screen. If there too many students to fit on one screen, the list will scroll up as you move down the screen. The top of the screen lists some special keys. They are: Key(s) Movement <AltB> Move to the beginning, left hand column. <AltE> Move to the end column, that furthest right. <AltI> Insert a new student before the student where the cursor is. If the cursor is at the end of the line, insert the new student after the current one. <AltD> Delete the student where the cursor is. This immediately deletes the student. <AltC> Change columns (discussed above). <AltS> Save the data to memory. It is not saved to disk. To do that, use the "S" option on the Main Menu. <AltU> Restore (undo) the data in that cell. This works only if you have not left the cell. <F10> Delete the data in that cell. <AltZ> Change sections for entering data. Alternatively, you can move around the screen with a mouse. The left mouse button moves the mouse to the position on the screen. The middle button (for three-button mice), deletes the data in the current cell. The right button is equivalent to pressing <Esc>. Lastly, pressing both the left and right buttons simultaneously is equivalent to pressing the <Rtn> key. If "mouse bars" are present on the right or bottom of the window, pressing the left button on the bars will move you to a different part of the data. 2. Enter the data You can use the cursor keys to move around the class and screen. Unentered scores are left blank. You can enter the new scores in the appropriate places. To keep the same score, type only a <Rtn> or use the cursor keys to move to the next cell. To enter a new number score, put in a new number between the minimum allowed points and the total allowed points of that task. Other numbers are rejected. The minimum allowed points are -1,000,000, while the maximum for any task is 62 Entering Grades 1,000,000. You can use decimal points in number scores. To enter a zero, you must type a "0". Cells for tasks that are left blank revert to unentered scores. NOTE: Scores higher than the allowed points for the task will not be accepted. A noise will occur when you leave the cell. The noise can be altered in the "Z" section of the Main Menu. If you are entering letter grades, only letters that are in the names of the grades are allowed (e.g., for grades from A to F, only the letters A, B, C, D, and F are allowed). Press <Esc> or <AltS> to stop entering scores. With <Esc>, the data in the current cell is discarded and you can quit without saving any of the changes (except deleting students by the <AltD> key), while <AltS> automatically saves it to memory, but not to the disk. You can also alter the student name, ID, and section numbers. To delete a student, delete the name (e.g., with <F10>), or use <AltD>. If you are low on memory, you might not be able to enter data for all the students. You can make the program use less memory by either: (a) Pressing <AltC> to change what coloumns are listed. Not listing ID, section number, student notes, or listing fewer tasks will save memory. (b) If there is more than one section of students in the class, press <AltZ> to have the program list fewer classes (e.g., list only section 2). (c) Reduce the amount of memory the program uses for overlays (see Chapter V, Section D). 3. Hints (a) It is helpful to give the tasks unique names. The names can be up to 20 characters long. You can enter scores into any defined task whether or not the task name exists. However, names will help you make sure you are entering scores into the correct task. When entering data for the whole class, only the beginning of the task names is listed. (b) VAR Grade can be used to add up points on any task. To use VAR Grade to add up scores for questions on a test, for example, you can define Task 20 as question 1, Task 21 as question 2, etc, in the "T" option on the Main Menu. Then, define Task 22 as the Sum of Tasks 20 and 21. 63 Voila! You can then use the program to add up the points on questions 1 and 2 of the task. You could then also use VAR Grade to do statistics on each individual question. If you have a large number of questions on the task, this could get a little tedious, as you need to define each question and enter the grades for each task. B. Entering Individual Student Data The "I" option of the Main Menu lets you enter task data for all tasks of individual students. The program will list all the number, letter, and extra credit tasks for one student. Use the cursor keys to move around the screen. You can alter any of the tasks, as well as the student names, IDs, or sections. Unentered scores are left blank. To delete a score, make the cell blank (e.g., with the <F10> key). To keep the same score, type only a <Rtn> or use the cursor keys to move to the next cell. To enter a new score, put in a new number between the fewest allowed points and the total allowed points. To enter scores less than zero, you need to change the fewest allowed points in the "G" option on the Main Menu. The minimum allowed points are -1,000,000, while the maximum points are 1,000,000. To enter a zero, you must type a "0". Press <Esc> or <AltS> to stop entering scores. With <Esc>, you can quit without saving the changes, while <AltS> automatically records the changes. You can also alter the student names, IDs, and section numbers. To delete a student, delete the name (e.g., with <F10>). The top of the screen lists some special keys. They are: Key Movement <AltB> Move to the first student in the class. <AltL> Move to the last student in the class. <AltP> Move to the previous student. <AltN> Move to the next student. <AltI> Insert a new student before the student where the cursor is. If the cursor is at the end of the line, insert the new student after the current one. <AltD> Delete the student where the cursor is. This takes immediate effect." <AltF> Find a student. You will pick from a list of all the students in the class. <AltS> Save the data to memory. It is not saved to disk. To do that, use the "S" option on the Main Menu. 64 Entering Grades C. Saving Entered Data to Disk It is strongly recommended that you save the data you have just entered as soon as possible after entering it. Although the program won't let you exit without saving changes, in case of power failures or computer failure, you will have a copy on disk of your new data. You save entered data in the "S" option on the Main Menu. You will be asked for the filename to save the data to. The current filename is listed on the line, and just pressing <Rtn> will do the trick. If you want to change the name, change it, then press <Rtn>. If you change the name, further updates will be made to the new name. WARNING: When you "save" data in the "D" or "I" options of the program, you are saving it to memory, not to a disk file. NOTE: The file that contains your student data is normally made a "read-only" file. This means that you cannot delete it with the DOS del or erase commands. You can tell the program to write your files "read-only", as "hidden" (the DOS dir command will not even list the file), or "normal". Normal files can be deleted in DOS. The program also makes backup files "normal", hence they can easily be deleted. Details on how to change the way the program saves the data are in Chapter V, Starting the Program. It is also recommended that you keep two copies of your class data on disk. To encourage this practice, the "F" (file) option on the Main Menu has a backup ("W") option to write the class to another directory or disk. The program will suggest writing the file to either drive A or B, so that the data will be on floppy disks. If you are using drive A for your class, the program will suggest drive B, otherwise it will suggest writing to drive A. You may pick any other drive or directory. Some users use VAR Grade on two different computers. If one of these has limited memory (less than 300K), versions 4 and above of the program will not be able to fit into memory. You can save your data in a format that earlier versions of the program will understand. To do so, when on the Main Menu, press <Alt2> (simultaneously press the "Alt" and "2" keys) to write the data in a way that is understandable to version 2, or <Alt3> to write version 3 files, or <Alt4> for version 4. WARNING: Some of the information in your class may be lost. Specifically, any task types that do not exist in the previous versions will be converted to ones that are understandable to that version (hence may not be what you want). If you do use this option, use only features in this version that exist in the previous version. 65 IX. ATTENDANCE Attendance dates can be defined and attendance entered for up to 240 different days. The attendance is entered by a whole class, or by individual students in a manner analogous to those for entering data for tasks. Attendance is found in the "A" option of the Main Menu. A. Defining Attendance Days You define attendance days in the "D" option of the Attendance Menu. There are two methods by which to define a new attendance day. First, to choose the next undefined day, press <F1>. Second, you can type in any number (from 1 to 240) as the day you want to define. In either case, you need to give the day a name or date. In fact, it is required that you enter a name or date before the attendance is defined. To make it easy to enter dates, the function keys <F3> through <F8> can be used to automatically enter the dates. The keys are defined as the following: Key Meaning <F3> The date two days ago. <F4> The date yesterday. <F5> The date today. <F6> The date tomorrow. <F7> The date in two days. <F8> The date any number of days from todays date, up to 365 days away. Enter the days. Example: To enter the date one week earlier, enter a -7. The dates that are entered are in whatever format you have chosen. These can be changed in the "Z" option on the Main Menu. With this option you can change how dates will be printed on documents as well as how they are entered in attendance. B. Changing Defaults By default, when attendance days are added, the student attendance is made "Present". There are six categories of attendance: Present, Excused, Unexcused, Late, Not Entered, and 66 Attendance Other. These have the characters " ", "E", "U", "L", "_", and "O", respectively. The default student attendance and the characters associated with them can be altered on the "A" (Attendance) option of the Main Menu, then "Z". The screen will list the current values. The default new student attendance will be highlighted or, if you have a monochrome monitor, underlined (unless you've changed the default colors). Use the cursor keys (or <Ctrl>-cursor keys) to move around the menu. To select a new default student attendance, press <Rtn>. The new value will now be highlighted. To change the letters for the different types of attendance, pick the new key. To simplify matters, any lowercase letters will be converted to uppercase letters. The allowed keys are the uppercase letters and the characters ".", "_", "-", and " ". C. Entering Class Attendance To enter attendance for all students in your class, use the "C" option of the Attendance Menu. This option works like the "D" option of the Main Menu for entering task data. 1. Choose the dates Students and days will be listed on the screen. Just as in entering task scores, to change the columns, use the key <AltC>. You can then pick which days to list on the screen, as well as whether to list the names, IDs, and sections. See Chapter VIII, Section A1 for more details. The most recently defined list of names and days are saved by the program. If you define new attendance days, they will automatically be added to the end of the list of days to display. The top of the screen lists valid keys and key codes for the attendance. Next the days are listed by name and number. The names are listed by the first several letters of the date. Student names and/or IDs are on the left of each row. If you have numerous days you want displayed, not all of them may fit on the screen at once. If you move to the right, more may be displayed. The names or IDs in the leftmost column are always displayed. 2. Enter the data You can use the cursor or <Ctrl>-cursor keys to move around the class and screen. The valid keys are listed at the top of the screen. Only those keys will be accepted. To delete a student, delete the name (e.g., with <F10>), or use 67 <AltD>. To add a new student, type <AltI>. When quitting this section, any changes made to the screen are recorded by the program by <AltS>, or possibly by exiting with <Esc>. D. Entering Individual Student Attendance To change attendance for just one student, use the "I" option of the Attendance Menu. The program will list all of the currently defined attendance days for a student. You can alter the attendance for any day, as well as the student name, ID, or section. To keep the same attendance, type a <Rtn> or use the cursor keys to move to another day. To enter a new attendance value, put in a new letter (from the list near the top of the screen). Press <Esc> to erase the data or <AltS> to save it when finished. To delete a student, delete the name (e.g., with <F10>), or use <AltD>. To add a new student, type <AltI>. For more details, see Chapter VIII, Section B. E. Default Attendance Task values When you define an attendance task, the program will suggest value for the number of days to discard and the weights for the various types of attendance. You can change these values on the Attendance Menu (the "V" option). The number of days you can discard is one less than the number of attendance days. The weights can be any number greater than or equal to zero. 68 Analyzing the Grades X. ANALYZING THE GRADES Grades can be analyzed a variety of ways. These are listed in the sections below. Furthermore, all the statistics and plots listed below can be printed on a printer or sent to a disk file. Chapter XI, Printing the Grades, explains the printing. The analyses in this chapter are generally from the "G" and "P" options of the Main Menu. A. Default Values for Analysis After you pick several of the options listed below, a screen will appear that asks how you want to proceed. Several options will be listed, including: (a) which printer to use; (b) what sections to use; (c) whether to print to the screen or to a printer or disk file; (d) whether to temporarily drop students from the statistical analysis. Picking a printer and deciding where the data should be displayed are discussed in Chapter XI, Assigning and Printing the Grades. The others are discussed here. 1. Sections If you have only one section of students in the class, this option is not displayed. Otherwise, the most recently selected sections will be listed. Each time you enter the program, the program will default to using all of the current sections of the class. If you change the list of sections to use, this new list will become the default sections for all parts of the program during the current session with the program. If you choose to use no sections, an error message will result and you will exit back to the Main Menu as there are no usable data. 2. Temporarily dropping students You can tell the program to temporarily drop students from the calculations for statistics and/or plots. This option can be used for students that have incomplete data. The number of students currently ignored are shown on the Print Menu screen. These students are ignored only for statistical purposes. You can still enter data, write 69 scores to printers, etc., unless statistical measures are needed (e.g., all plots). When you need to increase or decrease the numbers of students to ignore, two lists of students will be shown: (1) all the students in the class, and, (2) those students who are temporarily dropped from the statistics calculations. You drop students by using either the cursor keys or by typing in the student names. The <F3> key can be used to switch between adding and decreasing the number of students to be ignored. These students will be ignored for any further statistics during the current session with the program or until they are no longer ignored in this part of the program. 3. Font selection You can change fonts from the Plot Menu. Font files must end in "CHR". You will be asked for the directory for the font files. The program will suggest "*.CHR". This will list all the font files in the DOS PATH. You can, however, change which drive to search by replacing *.CHR with, for example: "A:*.CHR". This will cause the program to search drive A for the font files. WARNING: Some fonts will not look good on some video monitors. 4. 2D versus 3D plots Most plots can be done either with bars that look two dimensional (2D), or with bars that look three dimensional (3D). The plots are otherwise the same. B. Plotting the Scores of a Class By selecting the "P" (plot) option on the Main Menu, the scores for any of the tasks can be plotted. The program lists the tasks and asks for a task to be plotted. On the Plot Menu, "P" will plot the scores, and "T" will give the same plot with 3-D bars. Plotting the scores follows the sequence below. 1. Choose a task You will see a list of all the tasks. To see any that are not listed on the screen, use the cursor or <Ctrl>-cursor keys. If you pick task zero or <Esc>, the program will exit 70 Analyzing the Grades this section without plotting an task. Otherwise, the task will be plotted. 2. Score ranges If you grade with numbers, you must specify the range of scores to plot (the high and low scores). The program will ask for these numbers. If you just type <Rtn> when asked for the high and/or low scores, the program will choose the highest or lowest score in the class. If there are no students in the range of scores you have chosen, an error message will result and no scores will be plotted. By picking different ranges of scores, you can zoom in on various groups of students to see how they have done, rather than seeing scores only for the entire class. One of the most useful features of picking the low range is to prevent a very low score from skewing the plot. Student scores not yet entered or lower than the fewest allowed points are not used for the plots. 3. Defaults As discussed above, after picking the task and a range of scores, you can pick which sections of students to use and where to print the scores. See Part A of this chapter for more details. 4. Plotting the scores The plot separates the scores into up to 25 categories of scores. It also shows the mean, median, and standard deviation of the scores for the task (see the section on "Calculating Statistics" below for a more complete explanation of what these statistics mean). It plots the numbers of students with the various scores. The statistics calculated are only for those scores in the range of scores you choose. If you vary the high or low range of the scores used, these statistical measures will change. On the plot, the mean and median are shown with arrows. At one standard deviation above and below the mean are additional arrows (listed as "+1", "-1"). If the standard deviations fall outside the range of scores plotted, they may not be displayed. 71 5. Listing the scores After the plot is shown, you will be asked if you want to see the list of students' scores. If you decide to see them, the program will list the students scores in two columns: (a) class order (dependent upon your method of sorting students) and (b) by scores on that task, from high to low. The rank order of the students is also printed, if you choose that option on the Print Menu (the program defaults to printing the ranks). If you just want to list the scores, but not plot the scores, pick "L" on the Plot Menu. C. Plotting the Scores of an Individual You can follow how a student is doing in your class by plotting the scores for that student on a set of tasks. By selecting on the Plot Menu the "I" for 2D bars, or "B" for 3D bars, you can plot trends for scores of any of the class tasks for an individual student. 1. Picking the tasks The program will list the tasks and asks you to pick which ones to plot. You have the option of plotting (a) the percentages of each task, (b) the sums (totals) of each task, (c) the T-scores, or (d) the standard deviations from the mean for each task. 2. Listing the scores The program will then plot the task scores and calculate the statistics. The program assumes that the student trend is a straight line: either the scores increase or decrease. Note that this is frequently not the case, hence, these results should be interpreted with caution. The program then calculates the best-fitting line for that trend, and plots it on the graph. The correlation coefficient for the tasks, and the mean, median and standard deviations are also calculated. These all may or may not be useful for understanding how a student is doing in the class. The statistics are listed on the screen after the graph is plotted. If you choose more tasks than fits on one screen, you will need to press a key to proceed through all the tasks. 72 Analyzing the Grades D. Calculating Statistics You can calculate statistics without having to plot the scores. Rather than plotting each task to calculate the mean, median, and standard deviation, you can pick the "G" (grade) option on the Main Menu, then pick the "M" option on the Grading Menu. You can then see these statistics for any combination of tasks. To calculate statistics, you need to choose which tasks to calculate statistics, and pick which sections to use. The data will be calculated only for those sections you have told the program to use. This allows comparisons between different sections or combinations of sections. Statistics will not be calculated if a task has not been defined or if the task has less than the fewest allowed points. The median is the score for the person exactly in the middle of the class, i.e., exactly half the scores are above that number and half are below that number. The mean is the number calculated by adding up all the student scores and dividing by the number of students in the class. If you have a "normal" or "bell-shaped" distribution of scores, the mean and median should be the same number. In practice they are usually different. The standard deviation is a measure of how the scores are dispersed. The larger the standard deviation, the greater the range in the scores. A score that is equal to the mean plus the standard deviation (called "one standard deviation above the mean") is approximately in the top 16% of the scores. For a normal distribution, two thirds of the scores should be within one standard deviation of the mean. How many standard deviations away from the mean a student has scored, therefore, is a measure of how the student did on the task in relation to everybody else. You can then compare scores between tests by comparing the deviations from the means for each student. E. Correlating Different Tasks By selecting the "C" or "3" options on the Plot Menu, you can plot the scores for any of the tasks against the scores for any of the other tasks. This helps you to see if there were any problems on one or both of those tasks. If the tasks are measuring different things, the scores will be widely scattered. This may be an indication that one or both of the tasks did not measure what you hoped it would. If the tasks are measuring similar abilities, the scores will tend to cluster near the diagonal. 73 1. 2D or 3D plots In contrast to the other plots, the two different plots for correlations look quite different. In the 2D plot, the scores are shown as x's. If two or more x's are on the same place, the x becomes thicker. For the 3D plot, 3D bars are plotted. The more students on a point, the higher the bars. To make the plot easier to interpret, it is slightly skewed. This makes it easier to tell the difference between tall bars and bars at different points on the graph. 2. Choose the tasks You must choose the tasks to plot on each of the axes. Any task can be plotted against any other task. To help in your selection, the program lists the tasks. If you pick task zero for either axis, the program will give an error message and ask again. To exit this section without plotting, type an <Esc>. 3. Pick a range of scores for each task If you grade with number grades, for each task that you have picked, you must pick the high and low scores to plot. If you just type <Rtn>, the program will pick the highest or lowest score in the class (whichever is appropriate). If no students are in the ranges of scores that you pick, no scores will be plotted and an error message will result. 4. Defaults As discussed above, after picking the task and range of scores, you can pick the sections, decide whether to ignore students, and change how to print the scores. See Part A of this chapter (above). 5. Correlation plot The plot shows a 20 X 20 matrix of the distribution of the scores. The correlation coefficient is calculated and shown. The coefficient ranges from 1.0 (the scores on the X-axis predict exactly the scores on the Y-axis) to 0.0 (the scores on the two axes are completely random with respect to each other) to -1.0 (the low scores on the X-axis predict high scores on the Y-axis, and vice versa). The closer the coefficient is to 1.0, the more closely the two tasks measured the same parameters or abilities (and hence the 74 Analyzing the Grades students scored more nearly the same on both the tasks). If the correlation coefficient is close to 0 or below it, then students who did well on one task did poorly on the other. If you decide that this result indicates a flaw in one or both of the test, the program will allow you to delete one or both tasks. For the 2D plot, two or more scores on the same point will show up as a thicker "x", while on the 3D plot, the bars will get higher and higher with each score. F. Statistical Plots of the Classes The last type of plot, the "S" option on the Plot Menu, shows plots of the mean, median, and standard deviations for one or more tasks. Furthermore, the "1" option on the Plot Menu will show how an individual student scored on those tasks compared with the entire class. 1. Pick the tasks The program lists the tasks and asks for which ones you wish to plot. You can choose to plot from one to forty tasks. If you want to plot an individual student against the scores, you will also be asked for a student record to plot. 2. Plotting the statistics The program will show the range of scores as bars. The mean is a wide line all the way horizontally across the bar. The median is a horizontal bar halfway across the bar, with some vertical lines in it. The standard deviation is shown as the vertical line, extending one standard deviation above and below the mean. At one standard deviation above and below the mean are horizontal lines extending halfway across the bar. If you are plotting the scores of a student as well, that student's scores are shown as arrows. The tip of the arrow is the position of the student's score. If you plot tasks that have a wide range of scores, some or all of these measures may end up compressed. The range of scores that are plotted are from the lowest to the highest obtained scores. The Y axis may extend down to 0 points, however, even if no scores are that low. The widths of the bars changes depending upon how many tasks are plotted; the more tasks, the narrower the bars. The X-axis shows the numbers of the tasks that were plotted. 75 G. Scaling the Tasks If you grade using number grades, you can scale the regular tasks differently. Pick the "G" (grade) option of the Main Menu, then the "S" (scale) option in the Grading Menu. You may add any number of points to an task, or multiply the task by any positive number. The total points for the task, after the scaling, must be less than or equal to one million and greater than or equal to the lowest allowed score. Point totals less than the allowed scores are summed as the lowest allowed score, while scores greater than the total task points are set at the total points. Students with scores that have not been entered are not changed (the score is still undefined). This part of the program allows you to conveniently change point totals for any task. It also allows you to add points to one section and not to others, as the scaling occurs only for those sections you choose. You cannot scale special tasks. The total points for the task, after scaling, will not change. If desired, you can readjust the total points manually in the "T" section of the Main Menu either before or after scaling the task. H. Setting the Fewest Allowed Points When the program starts, the fewest points that a student can have on a task is 0 points. If you want to enter scores less than 0, you can set the fewest allowed points to be less than zero. On the "G" option of the Main Menu, the "F" option allows this. You can reset the number to as few as -1,000,000 points. Even though the fewest allowed points may be 0 (or any other number), you can still put in scores less than the fewest allowed points. Students with scores less than the fewest allowed points will always be ignored for statistical tests, and are considered to be equivalent to unentered scores. The difference from unentered scores is that unentered scores can either be ignored or set to 0 for special tasks, while numbers below the fewest allowed points will always be ignored. When you print the numbers, both types of scores will be blank or print as "Not submitted". If you set unentered scores to zero, numbers below the fewest allowed points will print as "*Not submitted". This will let you distinguish between the two types of scores. I. Assigning Standard Deviations and T-Scores Standard deviations and T-scores tell you how a student did in relation to the other students in the class. You can calculate the standard deviations and/or T-scores of a task for the class, and assign these numbers to a number task. Go to the 76 Analyzing the Grades "G" option on the Main Menu. On the Grading Menu, press "V" for standard deviations, or "T" for T-scores. You will be asked which task to use for the calculations, and to which task to assign the new scores. WARNING: The new task will be redefined as a number task. If you assign standard deviations and T-scores, approximately half of the scores will be below zero. Make sure that you change the fewest allowed points to a number below the lowest standard deviation or T- score (see Section H, above). J. Adjusting the Statistics of a Task In unusual circumstances, you may want to manually adjust the mean, median, and standard deviation of a task. The "A" option on the Grading Menu lets you do this. The "D" option lets you remove those adjustments. To adjust the statistics, you need to pick the task to use. Student scores are adjusted by changing the standard deviation and the mean. The current values are then displayed. You can change one or more of these values to any numbers you want. The student scores are now also adjusted to reflect the new mean and standard deviation. These numbers are then used by all the other parts of the program that calculate these values. To return to the true values, use the "D" option on the Grading Menu. Note that, if you revert to the original scores, they may be slightly different than the true original value due to rounding off errors. K. Changing the Grading Names VAR Grade can use just about any grading system you want. The program defaults to the grading system commonly used in the United States: A through F, with + and - scores. However, you can define any grading system that has up to 50 grades (plus a "unentered" or "incomplete" grade). Each grade can have a name of up to two characters long. The grading system can have the highest grade as the highest score, or the highest grade as having the lowest score. Furthermore, you can assign point totals to the grades. To change the grading system, go to the "G" option on the Main Menu. Choose the "N" option on the Grading Menu. Next, you will be asked whether to use one of a few pre-defined grading systems, or to define your own system. If you define your own grading system, you will be asked to enter the grade names, then the point totals for the grades. These point totals are 77 the values for the grades, not the scores that are needed to obtain the grade (see Section L to do this). Grade names and point totals can be changed at any time. The program converts all letter grades to numbers and stores the numbers. WARNING: If you change the grading system after assigning letter grades, the new numbers may translate into a different grade than you want. L. Picking Automatic Grade Cutoffs If you always use the same grading system, you may want to set the grading system in the "C" option of the Grading Menu. For instance, you can tell the program that 90% is an A, 80% is a B, etc. Alternatively, you can tell the program that 90 points is an A, 80 points a B, etc. When you assign grades, VAR Grade will use these values, either as percentages or points, as the point system to use when assigning grades. You can change the grading system at any time. To remove the cutoff points needed for various grades assigned in the "C" option, use the "R" (remove) option of the Grading Menu. The program will again ask you for the lowest scores for each grade every time you assign grades in the "G" option of the Main Menu. If you define a Final grade task, it will use, by default, the values of the cutoofs in effect when the task is defined to compute grades. If you change or remove the cutoffs, this will not change the grades in any Final grade tasks that have already been defined. Any new Final grade tasks will use the latest cutoffs. To change the cutoffs of Final grade tasks that have already been defined, use the "G" option of the Main Menu to assign new grades. 78 Printing the Grades XI. ASSIGNING AND PRINTING THE GRADES AND ATTENDANCE You can print out the grades and attendance of a class by four methods: 1. Plot the scores of a task. The program will list the student scores for that task in numerical order and in sorted order (see Chapter X, Analyzing the Grades). 2. Print grades or attendance for any combination of tasks and sections or names with the "W" (write) option on the Main Menu--discussed below. 3. Assign and print the grades with the "G" (grade) option on the Main Menu. This method is also discussed below. 4. Write a report form, then use the "W" option on the Main Menu to select the form to write the data. A. Default Values for Analysis After picking several of the options listed below, a menu will appear that asks how you want to proceed. Listed on the menu will be several options, including: (a) which printer to use; (b) what sections to use; (c) whether to print to the screen or to a printer or disk file. The options listed will vary in different parts of the program. Some of the options are listed above, in Chapter X, Analyzing the Grades. 1. Choosing a printer When you install the program, you are asked which printer you will be using. If you want to change which printer will be used or how to print (single or double spacing; pica or elite; etc.), press "Q" on the Print Menu to get to the Printer Menu. The Printer Menu can also be reached in the "Z" option of the Main Menu. NOTE: Any time you are printing to a disk file or a printer, you can stop the printing by pressing <CtrlS>. You will be asked whether to stop printing. If you answer yes, no more printing will be done. (a) Installation of a printer To install a new printer, press "P" on the Printer Menu. The program INSTALLP must be on a disk or directory that 79 the program can find, and there must be enough memory to run the program INSTALLP. It will list all the currently supported printers. Use the cursor keys to locate the printer(s) that you wish to install. When you find each one, press the space bar. After you have picked up to 5 different printers, press the <F10> key to install the printers. To quit before installing the printers, press <F3>. This will install the Graphics printer codes. If yours is not listed, your printer manual should list the printer(s) that it emulates. NOTE: The list of supported printers will be continually updated. If yours is not supported with the version that you have, an update may be available that will explicitly support your printer. When you install the printers, the program will change the file GRADE.PDT. For many of the printers, the Line printer codes will also be installed. For others, however, you also need to tell the program which printer codes to use. Pick the "L" option on the Printer Menu. Listed will be several different printers that are frequently emulated. Most printers emulate the Epson FX- 80 printer. If yours does, pick that. If not, it may emulate one of the other printers listed below. Some printer manufacturers and the printers they usually emulate is listed below. If your printer is not listed, or if you want to change the printer codes for your printer, use the "U" option on the Printer Menu to put in the printer codes. The program will keep track of the line printer codes for each of the five printers that can be installed. Line Printer Definition Printers Supported Epson FX-80 Most Epson printers, including the EX, FX, MX, and RX series. Also, many printers from Brother, Citizen, Panasonic, and others. IBM Graphics Printer IBM dot matrix, Okidata with IBM emulation, Star Micronics, and others. HP Laser Jet HP LaserJet, Plus, Series II, DeskJet, PaintJet, and most laser printers. NEC P-2200 Most NEC printers. Okidata 92 Okidata 84, 92, 93, 192, 193, 292, and others. 80 Printing the Grades (b) Changing the line printer codes To change the printer codes, press "U" on the Printer Menu. Listed will be the current printer codes. To change them, use the cursor keys to move to the code that you want, then press the correct codes. Your printer manual will list the codes needed to use pica, elite, etc. printing. NOTE: Some of the keys work differently in this part of the program, as you need to be able to enter any possible printer code. To enter escape (#27), press the <Esc> key. The backspace key will enter <CtrlH> (#8). The enter or <Rtn> key will enter <CtrlM> (#13). To enter codes below 32 or above 127, hold down the <Alt> key, then use the keys on the numeric keypad to enter the number. You can enter up to 10 characters for each of the codes. To backspace (remove the previous character), use the <F2> key. After you exit with <AltS>, the new codes will be in effect. Pressing <AltE> will switch between listing the codes as hex numbers or as text. (c) Changing the graphic printer codes If your printer is not supported, or if the printer codes that are used by the program are not producing the results that you want, the program BDE (Baby Driver Editor) can be used to change the codes. To change the codes, exit VAR Grade. Put the Utility disk into a drive, and type "BDE \path1\GRADE.PDT". Path1 is the directory where the file GRADE.PDT is located. If BDE cannot find GRADE.PDT, there will be no codes to modify. If you have a monochrome monitor, you need to add a " -m" at the end, so type: "BDE \path1\GRADE.PDT -m". When the program starts, you will see a list of all the installed printers. You can change any of the listed printer codes or values by finding the printer, pressing <Rtn> to select it, then altering any of those values. If you need help, press <F1>. When you are finished, press <F10> to install the new codes, or <F3> to exit. NOTE: The program BDE is sent to registered users. All other users can obtain a copy of it by sending $10 (US) to the address listed above for registering the program. (d) Printer errors If there are problems with your printer (not turned on, out of paper, etc.), the program will put out an error message. Sometimes the error message may mistakenly state 81 that the error is a "disk" error instead of a printer error. In either case, try to correct the error before telling the program to continue. If the error is not correctable, output to the printer will stop. In most cases, the printing is just turned off. (e) Changing installed printers After you choose your printer, the choice is written to a file called "GRADE.PRT". This file also contains the various line printer codes, and is written to the current directory. To change the printer, go to the Printer Menu, then select the number of the printer you want to use. If the printer is not listed, it is not installed, and must be installed before it can be chosen. If you have your classes each in different directories, you can have each class set up to print differently. The program searches for the GRADE.PRT file in the current directory first, then searches for the file in the directory where the program is located, then, if still not found, searches for the file in a directory specified by the DOS PATH command. (f) Changing the printer ports The program assumes that you are using the first parallel printer port, called LPT1 (also called LST or PRN). To change this, you can pick either of several parallel or serial ports as the destination of the printing for each of the five allowed printers. No checking is done by the program for the presence of the port, so if the port you choose does not exist, you will not be able to print data. 2. Print options The "Z" option of the Printer Menu lets you change how the page is output to a printer or disk file. (a) Line Spacing Single, double, and even greater spacing of lines can be printed. Changes from single line spacing occur when output is sent to a disk or the printer, never on the screen. Also note that the plots are always single spaced. (b) Margins 82 Printing the Grades You can set up the left, right, top, and bottom margins of the pages. The left margin is the number of characters to leave blank on the left side of the page. The right margin is set indirectly: you specify the number of characters on a line. If you decrease the number of characters, the line is shorter, hence you have a larger right margin. The header and footer set the lines at the top and bottom of the page. The page numbers are written in the footer, while the running head on the top right of the page is written in the header. Setting either to 0 will prevent them from being written. You can also stop page numbers from being written by telling the program to stop printing page numbers. Lastly, you can specify the number of lines on a page. A typical 8 1/2" by 11" page in pica mode has 80 characters on a line and 66 lines. Elite has 96 characters and 88 lines, while compressed has 136 characters and 110 lines. Some laser printers only print 60 lines in pica, 80 in elite, and 100 in compressed. This flexibility also can cause problems. If you have set the number of characters to a very small number, you can truncate some of the data sent to the printer. If only the left part of the graph has been written, check the margins that you have set to see if that is the problem. If the program doesn't break the pages in the correct place, try increasing or decreasing the lines on a page. (c) Listing ranks You can have VAR Grade print out the rank of each student when listing the students in the class. This option can be turned on or off in the Print Menu. Student ranks will be listed by whatever sorting method you have chosen (see Chapter VI, Section E, above). For example, if you have sorted the class by student names, the ranks printed will be the alphabetical order of the class. If you sort by the score on an task, the ranks will be by the score on that task. Note that if you sort the class without regard to sections, then print them by sections, the numbers will not necessarily be consecutive for each student in each section. 83 (d) Printing Notes You often enter notes that you do not want printed out. VAR Grade, therefore, will print the notes only if you tell it to. You can toggle (switch on and off) whether to show the notes. If the toggle is on (the notes will be shown), when data is printed, the notes will also be printed. NOTE: When printing final grades from the "G" option of the Main Menu, the notes may not all fit onto the lines when printing both the student ID and names and may be truncated. To print out notes that you have entered into the student records, you need to tell the program to "show" the notes. Pressing "T" on the Write Data Menu will let you indicate whether to show the notes. You can also indicate whether to show the notes in the Print Menu that is always seen before you print your data. For those parts of the program where you can print notes, there is an option on the Print Menu that lets you toggle whether to show the notes. (e) Decimal places When printing classes by sections, you can specify how many decimals to print the scores. Number, sum, extra credit, and highest tasks are set, when you first run the program, to 0 decimal places. Average, weight, attendance, and percentage tasks are set to 2 decimal places for printing. You can change either set to between 0 and 5 decimal places in the "Z" section of the Main Menu. 3. Disk files When you print files to disk, they are printed as ASCII files. This means that you can then use a word processor to alter them in any way that you want, or use the word processor to print the files. If you pick the "D" (print to disk) option, you will be asked the name of the file. Any name can be used, as long as it is a valid MS-DOS filename. Pressing <Rtn> will cause the default disk file listed to be written; pressing <Esc> will turn off the printing to a disk file. In case of a syntax error in the file name, the program will ask for a new name. The program checks to see whether there is enough space on your disk and to see if a file with that name already exists. If there is not enough 84 Printing the Grades space on the disk, the program will stop sending files to the disk. If you are printing a graph or plot, the program will write the plots to a file with the same filename, but the extension (the part after the period), will be changed. NOTE: The plots are not written in ASCII letters, but will be written for whichever printer you specify. These can be printed from disk to your printer by typing "COPY file.ext PRN". Each type of plot has a different letter in the extension (the first letter of the suggested extension), with a number from 00 to 99 after it. For example, printing a plot to a disk file for the class GSAMPLE will produce a file "GSAMPLE.P00". If that file already exists, it would be written to "GSAMPLE.P01", etc. The disk file that you specify will contain a line in it telling you the name of the file for the plot. 4. Class name In addition, in the "Z" option of the Main Menu, there is an option that will let you rename the class with up to 15 characters. This rename is for printing purposes only, and will not change the file name of the class. When VAR Grade prints data to a printer or disk file, it also prints the name of the class. Renaming the class will override the default name (which is the one used when starting the program). Example: The class is called "BIO" when you tell VAR Grade to use it. The default name for printing would be "BIO". You can change it to anything else, e.g. "Biology 100", for printing purposes, but the file name(s) will still be BIO (plus the extensions ".PAR" and ".DAT"). B. Printing the Student Scores and Attendance If you want to print out a list of the students and their task scores, select the Main Menu choice "W" (write). This is the Write Data Menu. You can print out all the task scores or attendance for one student ("by name") or for whole sections of students ("by section"); you can print a grid for entering scores; or, you can export data in formats that can be read by other programs. 85 1. By name After you select these options, you will see a list of students in the class. If there are more students than fit on one screen, you can use the cursor keys to locate the desired student. The highlighted name can be chosen by typing <Rtn>. You can also pick a name by typing it in at the prompt. If you are searching for a student in the class, you only have to type in the first characters of the name that match the desired name and that do not match any other names. Example: if you type "ken" when picking a student, the first student with the letters "ken" in the name will be found. "ken" would find "Kravitz, Ken" in the GSample class. However, it could also find a name like "Kendrow, John". Note that you can also use the cursor keys to find any name. If you type in the name, and there is more than one section of students in the class, you must enter the section number for the student (or <F1> to search for the section--note that the program will find only the first occurrence of the name). If you want to print scores for all the students, press <F1> when the program asks for the student names. You will be asked whether to print them one student per page. If you answer "y", a new page will be started for each student. If you answer "n", the program will fit as many students on a page as it can. If you picked the "L" option on the Print Scores Menu, you will need to choose which tasks to list for the student(s). If you pick the "N" option, all the tasks will be listed for the student(s). If you use attendance in your class, you also need to choose whether you want to write attendance, tasks scores, or task scores and a summary of attendance. The program first lists the name of the student, the ID, the section, and the date the data was printed (i.e., the current date). It will then list the defined tasks by number and name as well as the scores for the student, the total points for the task, and the percentage of the total points for the student score. If you grade with letter grades, the total points and percentages are not listed, since they are meaningless. If no score was entered for the student, it is listed as "not submitted". For attendance, VAR Grade will list all the dates and attendance. For the attendance summary, a list of the totals for each attendance category will be printed. If 86 Printing the Grades you list the scores to a printer or to a disk file, VAR Grade will break the listing into pages. You can change such things as margins, type styles, etc. before you print the class from the Print Menu (see above). 2. By section If you select this option, you must pick the tasks or attendance days to print, ending the input with a <Rtn>, followed by a second <Rtn> (with no other characters) or "0" <Rtn>. This tells the program that you are finished putting in task or attendance numbers. NOTE: If there are too many tasks or attendance days to print on one screen, the program will print out as many as fits across the page for a whole section, then more, etc., until all tasks and students have been printed. If you are printing more than one set of tasks, or more than one section of students, the program will ask if you want to print them one set per page. If you answer "y", the program will start a new page for each new set of tasks or section of students. If you answer "n", the program will fit as many on a page as it can. After specifying what to print, you reach the Print Menu. If the wrong section, printer, or other options are listed, change them before specifying where to print the data. If you are printing the student notes, they will be printed after any tasks that you have chosen. We always recommend that you print the scores on your printer immediately after entering task scores, just in case there is a computer or disk malfunction. If you print the scores on your printer, using elite type and single spacing will allow more scores to be printed per page than pica printing. As mentioned above, you can set decimal places, margins, page lengths, characters per line, etc. from the Printer Menu. Although you may have entered scores using several decimal places, they will be printed using the number of places to the right of the decimal that you specify. NOTE: The program keeps grades using 15 significant digits, but may not print that many. When printed to the printer, page lengths are calculated and the printing formatted accordingly. The date is also printed so that you know when you last printed your class data. 3. Printing grids For entering student data, it is often useful to list the students with a blank grid. You can then use it to record 87 the grades. The grid can make it easier to enter the student grades into the computer. The program will just list all the students in the class and empty boxes (grids) for entering student data. Attendance grids have twice as many boxes as regular grids. C. Calculating and Printing Grades To calculate and print grades on a task (or final grades) use the "G" (grade) option on the Main Menu, then "G", "P", or "3" on the Grading Menu. 1. Choose a task First, pick which task to grade. The program lists all the valid tasks. If there are more tasks than can be listed on one screen, use the cursor keys to see more tasks. Task 0 or <Esc> is interpreted as no task (exit). Only non-letter grades can be picked (the others already have the grades assigned). If you pick a final task, the grades will be assigned to it. Otherwise, the grades are printed, but no record is made of the grades. 2. Defaults As discussed above, after picking the task and range of scores, you can pick the sections and how to print the scores. 3. Plot and cutoffs If you selected the "P" or "3" options on the Grading Menu, all the scores for the sections specified will be plotted; otherwise, the "G" option skips the plotting. You then must select the LOW cutoffs for each grade (unless you have already set the cutoffs in the "C" option of the Grading Menu). Depending upon your grading system, up to 49 cutoffs need to be entered. If you just press enter for a cutoff, the program will select the same cutoff as the previous cutoff (hence nobody will receive that grade, and the totals for that grade will not be listed at the end of the class). Names and values should be entered in numerical order. 4. Listing the grades The program will list the total points (or averages) and grades, by section, for the selected task. A table of numbers of students with each grade and the cutoffs are then 88 Printing the Grades listed. The program will ask whether these grades are acceptable. If you choose no ("N"), the plot and cutoffs will continue to be repeated, with new cutoffs, until you say they are acceptable ("Y"). When the data is printed out, the classname, section, task, and date are also printed. If you have picked a task defined as a Final task, the program will save the grades for the students on that task, as well as the new cutoffs. The grades for that task will then be recalculated each time you enter scores. If it is not a Final task, it does not store the assigned grades and cutoffs anywhere in the program. If you print notes, they will be listed on the right hand side of the page. WARNING: If you are printing with both names and IDs, the notes may be truncated. D. Exporting Data You can export data from a VAR Grade class in three different formats. Other programs can then read the data. For all three methods of export, you can specify whether to write names, IDs, and sections, as well as any combination of tasks. If you want student notes to be written, make sure that the you have you have told the program to show the notes (i.e., set the toggle) before you export the data. 1. Comma and quote file A quote and comma file is an ASCII file where strings (names) are enclosed in double quotes (""), while numbers are not. Cells of data are separated by commas. Many spreadsheets can import this type of file. Each cell get imported into one cell in a spreadsheet. Each line in the file ends up as one line in the spreadsheet. 2. Flat file A flat file is an ASCII file where data is separated into columns. The columns are separated by spaces. Many spreadsheets can import data in this format. 3. Byte file This type of file is not an ASCII file. It is included either as a last resort, so you can write your own converter, or to work with report card programs that may be on the market. The names are written with 20 characters, 89 then the IDs with 15 characters, student notes with 20 characters, sections as 2-byte cardinal numbers, and tasks as 2-byte letter grades for letter and final tasks or 8-byte floating point numbers for all other tasks (1 sign bit, 11 exponent bits, and 52 bits for the significand). If specified, the order is: name, ID, notes, section (written if there is more than 1 section in the class, otherwise not written), then the list of tasks, in the order you chose. E. Reports A simple programming language, named VRL (VAR Grade Report Language) has been added to VAR Grade so that you can write reports that include your class data. The language will allow you to write just about any report that you might want. The reports are written in plain text (ASCII characters) that are called report forms. These forms are translated by VAR Grade into complete reports. Included with the program are several forms that can be used by you for your classes, or used as examples to help you write your own reports. The language used for the forms can be used to emulate any of the types of output that VAR Grade already does. It also lets you write reports that can include data on students from more than one class, so that you can have the program write reports that will consolidate the grades for your students that are taking more than one of your classes. Overview of the VRL language The purpose of VRL is to let you access just about any piece of data of your class. It is also a forgiving language, in that if you make a mistake, the program will not blow up or go into computer heaven. Instead, mistakes will show up as reports that do not look how you want them, and will usually result in the incorrect commands appearing in square brackets in the output. Each command in the VRL language starts with a left square bracket "[", and ends with a right square bracket "]". The only exception to this are comments, which start with a left curly bracket "{" and end with a right curly bracket "}". The form that tells VAR Grade what to do is read line by line. This means that commands must be entirely on one line. You can have as many commands on one line as will fit. Each line in the form can have up to 255 characters, with no limit on the number of lines. The commands can be broken down into several categories. First, there are comments. The comments are ignored by VAR 90 Printing the Grades Grade, but are useful for commenting on what you have done. Second, there are printer and format commands. Printer commands tell the printer to do something, such as print the next part with bold type. Format commands tell the program to change the way things are written, such as to go to the next page (called a "formfeed"). Third, there are commands that let you write class data. These let you write student, task, and attendance data. Fourth, there are commands that tell the program to change something. These are used to change or switch data, like changing the class, to switch to a different task, and so forth. Fifth, there are commands that tell the program to repeat things. These allow you to easily write lists of students and tasks. Last, you can write out text. Anything that is not in brackets is written exactly as it is in the report form. Commands can also be formatted. This means that you can specify not only to write a particular score or name, but also how to write it (spaces, how many decimals, etc.). Different commands need different types of formatting, so the relevant formatting will be discussed with each command. In the explanations, the commands need to have square brackets around them. Subcommands, like those in the Print command, need to have the command and the subcommand between the square brackets. Although spelling is important for the commands, they can be in any mixture of upper and lower case letters. If you want to write a left square bracket in your text, you can do so by writing two consecutive square brackets ("[["). Extraneous material that is written after the commands, but inside the brackets, is generally ignored. Writing report forms Before writing report forms, you should do three things. First, read the following sections on what the commands do. This will let you know what types of things you can do, as well as what some of the funny looking commands mean. Second, browse through some or all of the forms included with the program. This will help you see how somebody else has accomplished what you might want to do. Feel free to copy, modify, and discard anything in the forms. Last, write the form in plain text (also called "ASCII" characters). Most, if not all word processors and all editors will write what you have written in plain text. If not, there are a number of good shareware word processors that can. 91 In the "W" (write) option of the Main Menu, there are several options for writing and editing forms. Designating an editor The "D" option on the Write Data Menu will let you designate whichever editor or word processor you want to use to edit or view report forms. The editor should be capable of writing plain text (i.e., in ASCII characters). You should enter the editor with whatever command you use to invoke the editor. If you have a hard disk or EMS memory, any word processor can be called from VAR Grade. If you do not have either, only word processors or editors that take up little memory can be called from the program. If your word processor takes up too much memory to be called from the program, you will not be able to edit report forms from inside VAR Grade. You could, however, exit the program and then edit the report forms. Editing forms The "F" option on the Write Data Menu will invoke the editor you have designated. VAR Grade will invoke your editor so that you can edit or view report forms. Forms can have any name. However, it is suggested that you use the extension ".FRM" for the forms. The forms included with the program all have that extension. If you use a consistent ending for the forms, it will be easier to find the one that you want. When the editor is invoked, it is invoked with: "editor *.FRM", where 'editor' is the name of your editor or word processor. Class reports This option, "C", is intended for using forms that write reports for all the students in your class. It will ask you for the name of the form to use, then will ask where to print the class data. If you use this option to print a form intended for individual students (see the next section), the first student in the class will be used as the "correct" student. Examples of class forms are listed below. 92 Printing the Grades Form Use Consolid.FRM Lists all the students grades on one task in each of three classes. This shows the capability of the report writer in being able to find and write the grades of students (having identical names) from different classes. Flat.FRM Emulates flat files. This writes all the students' names, IDs, sections, and notes as a flat file. Quote.FRM Emulates quote and comma files. This writes all the students' names, IDs, sections, and notes as a quote and comma file. Section.FRM Lists all the grades for all the students in the class. This emulates the "Write students in sections" option of the Write Data Menu. Individual reports This option, "I", is intended for using forms that write reports on individual students. A second menu will appear, asking if you want to write a report on one student, all students below a designated score on a task, or all students above a designated score on a task. If you choose to write a report on one student, you will be asked for the name of the student. If you pick either of the other two options, you will be asked for the task and the cutoff score. Each student in the class that is above or below the cutoff (whichever option you chose), will have the form printed for him or her. This will let you write a report telling the low students to shape up and a different report praising the top students, each listing the relevant grades for the student. Examples of class forms are listed below. Form Use Classes.FRM Lists the grades for a student from three separate classes. This shows how to write a report that consolidates the class data for one student into one report. 93 Form Use Low.FRM This is an example of a report that will tell the parents of students that their child is not doing well enough in your class. Name.FRM Lists all the grades and data for one student. This emulates the "Write data for a student" option of the Write Data Menu. Report.FRM This shows the capability of writing a free form report that tells the students in your class how they are doing. Comments Comments are words bracketed by "{" and "}" (see example 1, below). When the form is printed, the comments are removed from the form. The purpose of comments, therefore, is to let you state what you have done in plain English so that the next time you look at the form, you will remember why you wrote it. Comments can be anywhere in the form. However, they cannot be nested (see example 2). If you want to put a left curly bracket into your text, put it in as two consecutive left brackets ("{{") (example 3). For a comment, if the right curly bracket is not present, the rest of the line is not printed (example 4). Examples: # Statement in Form Program Output 1 {This is a comment} 2 {This is {a} comment} comment} # Statement in Form Program Output 3 {{This is a comment} {This is a comment} 4 {This is a comment NOTE: For comments that take up an entire line, like example 4, that line will not be printed. 94 Printing the Grades Printer and format commands Printer Commands Printer commands tell your printer to do special things. You can tell your printer to print things in bold type, or even enter printer commands directly into your forms. These commands have the form: [Print"subcommand"] or [Print'subcommand'], where subcommand is one of the subcommands listed below. SubCommand Description '' Anything between the single quotes is sent to the printer. The purpose of this command is to send any special printer codes to the printer that you want. A "#" tells the program to print the next number(s) as ASCII codes. Example: [Print'#100'] means to print ASCII character 100 ("d"). A "@" tells the program to print the following characters exactly as they are listed. Example: [Print'@100'] means to print "100" (not "d"). NOTE: All the commands listed below start and end with double quotes ([Print"command"]). BoldOn Sets the printer to start printing with bold characters. BoldOff Turns off bold printing. Chars=# Sets the number of characters on a line, where "#" is a number. Example: [Print"Chars=50"] tells the program to set the number of characters on a line to 50. Compressed Sets the printer to print in compressed text (17.1 characters per inch, 8 lines per inch). Elite Sets the printer to print in elite text (8 characters per inch, 8 lines per inch). High Sets the printer to high quality text. SubCommand Description 95 Lines=# Sets the number of lines on a page, where "#" is a number. Example: [Print"Lines=44"] sets the number of lines on a page to 44. Normal Sets the printer in draft (normal) quality text. Offset=# Sets the number of spaces to be printed at the beginning of each line, where "#" is a number. The higher the number, the further from the left side of the page the document is printed. Example: [Print"Offset=5"] prints five spaces at the beginning of each line. Pica Sets the printer to print in pica text (6 characters per inch, 6 lines per inch). Format commands These commands alter how the printed form will look. Command Description EndOfPage Write a formfeed (end of page character). This starts a new page on the printer. Any forms longer than the number of lines on a page are automatically broken into pages. The EndOfPage command lets you pick where the pages will break if you want certain items to end up on the same page. Just Left justify strings. Names, dates, etc. can be written with a defined length (e.g., you can have the student names written with 25 characters). Left justification will write the names starting with the first character. Example: "Student Name............." (the periods are there for illustration purposes, only). This is the standard way of writing names, etc. NotOnePerPage More than one student or set of students per page (default setting). See "OnePerPage" OnePerPage One student or set of students per page of output. Page breaks will be inserted after each student or set of students. 96 Printing the Grades Command Description RJust Right justify strings. Names, dates, etc. can be written with a defined length (e.g., you can have the student names written with 25 characters). Right justification will write the names from the rightmost character. Example: ".............Student Name" (the periods are there for illustration purposes, only). Commands to write or switch data There are quite a number of commands for accessing or switching data. These are listed below in several groups: student data, task data, and class or generic data. For most of the data, you can tell the program how to format the output. For almost all of the commands, you can tell the program how many characters to write the data. This is useful for formatting columns. Example: [Name:25] tells the program to write the student name 25 characters wide. Since the name is less than 25 characters, the rest will be written with blanks. [Name] will write only the name, with no extra blanks. For numeric data, you can tell the program how many numbers should be written after the zero. Example: [TaskScore:10:3] will write the data 10 characters wide, with 3 numbers after the zero: xxxxxx.xxx, where x is any number (notice that one space is taken by the period). If you specify a length that is less than the required spaces, the entire piece of data is written. Example: [TaskScore:0:3] will write the data with as many spaces as needed, but including three numbers after the decimal. NOTE: Formatting of commands, which are the ":#" seen after the commands listed below, are optional. Class or Generic Data These commands access class data, switch between classes, or access things like the current date. Command Description "":# Anything between the double quotes ("") is printed. The only reason you will probably need to use this command is to specify the width of headers, etc. when formatting tables. 97 Command Description AttTotal:# Prints the total number of class days. Class=# Switches the class to another one. The "#" must either specify a valid name of a class, or specify nothing. It is specifies nothing, the original class will be used as the current class. Up to 7 classes in addition to the original one can be kept in memory at once (unless you run out of memory). If you have the same students in several classes or subjects, this can let you write one report form that will put all their data onto one printout. ClassName:# Prints the name of the current class (Note: it does not print the filename, but instead the name you specify for printouts in the "Z" option of the Main Menu). Date:# Prints the current date. Student Data These commands access the student data, including grades and attendance. Command Description AttExcused:# Prints the number of days the student has had an excused absence. AttLate:# Prints the number of days the student has been late. AttNotPres:# Prints the number of days the student has been absent from the class. AttOther:# Prints the number of days the student has been "other" from the class. Other can be used for any meaning by you. AttPresent:# Prints the number of days the student has been present in the class. AttTotal:# Prints the total number of class days. 98 Printing the Grades Command Description AttUnex:# Prints the total number of unexcused absences by the student. ID:# Prints the ID of the current student. Name:# Prints the name of the current student. Note:# Prints the notes of the current student. Section:# Prints the section of the current student. TaskPer:#:# Prints the percentage score that the current student scored on the current task. TaskScore:#:# Prints the score on the current task for the student. Task Data These commands are used to change or specify the tasks to use. In general, you want to change or specify the current task with Task or DTask, then print the data with the other commands. Command Description DTask Defines a task as the current one. No data is printed. The task can be specified many ways: (1) [DTask#x], where x is the number of the task. (2) [DTask@x], where x is the xth task you have defined. (3) [DTask(x)], where (x) is the total number of tasks in the class /x. Example: If there are ten tasks defined, [DTask(2)] is the fifth task. (4) [DTask?]. "?" means that the program will ask you to select the task when it reaches that point. (5) [DTask+]. The "+" can be added to any of the first three definitions, and tells the program to increment the number by one. [DTask+] will increment the current task by one. [DTask(2)+] will, if there are 16 tasks, make the current task the ninth one (16/2 = 8, then add one). (6) [DTask"name"], where name is any word or 99 Command Description DTask (cont) characters, will select the first task that matches the characters. So [DTask"First"] will select any task with first in the name (e.g., "First Exam" or "The first test"). (7) In some circumstances, like the [Loop] command described below, just a plain [DTask], without any designation of a number, is required. When [Loop] is used, the plain [DTask] is modified to have the required number for the loop. Task:#:# This works like DTask, except that, after the current task has been changed, the score for the current student on that task is printed. TaskName:# Prints the name of the current task. TaskNum:# Prints the number of the current task. TaskPer:#:# Prints the percentage score that the current student scored on the current task. TaskPts:#:# Prints the total attempted points of the student on the current task. If all the task scores have been entered, it will be the same as TaskTotal, below. TaskScore:#:# Prints the score on the current task for the student. TaskTotal:#:# Prints the total points of the current task. Repetitive commands These are commands that are used to write lists of students or tasks. There are three commands: repeat, loop, and students. There is also a related command: header. Command Description Header For the following repetitive commands, [Header] will print whatever is on the header line at the beginning of any new page. This command will let you write long lists of students or task scores, each with a header on the top of any new pages. 100 Printing the Grades Command Description Loop Repeat more than one line. Any lines between [Loop] and [Loopend] will be repeated. Note that the lines containing [Loop] and [Loopend] are not printed. Tasks specified with the commands [Task] and [DTask] that are found between the [Loop] and [Loopend] commands are incremented between repetitions Note: [DTask#1], [Task@1], etc, will not be incremented within Loop, so use plain [DTask] and [Task]. The [Loop] command can be modified by telling the program how to increment the Tasks. [Loop:#:#] is used specify, in order the beginning task to use and how much to increase the task numbers each loop. Example: [Loop:3:2] will print tasks, starting with the third task and increasing the task numbers by 2 each time the loop is repeated. If the "#" numbers are omitted, it is assumed that the loop should start at the first task and increment them by one each time. [Loopend] can also be modified. In [Loopend:#], the "#" is the number of the last task to be printed. Example: [Loop:3:2] [Task] [Loopend:7] will print out the scores for the third, fifth, and seventh tasks. The loop will end when the last task in the class is reached. So, in the above example, if there were only five tasks in the class, only scores for the third and fifth tasks will be printed. 101 Command Description Repeat# Write the information on the line, but increment the task numbers on the line by one each time the line is repeated. "#" is a number. If "#" is not present, the line will be repeated once for each task in the class. If "#" is a number, the line will be repeated that number of times. If "#" is a number in parentheses, like "(2)", the line will be repeated by the quantity: the total number of tasks in the class / that number. Examples: If a class has 16 tasks that have been defined, [Repeat] will repeat the line 16 times; [Repeat(2)] will repeat the line 8 times; [Repeat5] will repeat the line 5 times. Note that, in each case, any task numbers on that line will be incremented by one each time the line is repeated. If "#" is a question mark, you will be asked, when the form is printed, for a list of the tasks to write. The line will be repeated enough times to write out that list. Students Write the information on the line for each student in the class, from the first student to the last one. The purpose of this command is to easily write out a list of students' data. Example: [Students][Name] will write the names of all the students in the class, one per line, starting with the first student and ending with the last student. 102 Other Program Features XII. OTHER PROGRAM FEATURES A. File Maintainance VAR Grade has a complete file maintainance section: "F" on the Main Menu. The intention of this section is to allow you to copy, move, delete, etc. any or all of your class files. Alter the current class file name ("A") This option will change the name of the class that is currently in memory. Both the class files and the backup files, if present, are renamed to the new name. Note that this is different than changing the class name for printouts. The name listed on printouts can be changed in the "Z" option of the Main Menu. Write the class to a backup disk ("W") This option will write the current class to a different directory or, preferably, drive. This will allow you to keep a copy of the current class on another drive. It is highly recommended that you keep copies of your class on at least two different drives. In the unlikely case of disk failure, you will have another copy of your class data. It is also advisable to keep a printed copy of your grades. Maintainance of one or more classes: The next five options can be used for file maintainance of any and all your classes, not just the current class as in the above two options. For each option, you can specify one or more files, and can use the DOS wildcard characters * and ? to help specify the files. You can also specify files on any drive or directory of your computer. The DOS wildcard character "*" means all files, while the character "?" means any character can be in that position of the filename. DOS extensions, those characters after the period (e.g., .PAR), are ignored. Instead, all class files associated with that name are renamed. 103 Example: If you specify "*", this would mean to do a particular operation on ALL class files. Example: If you specify "ART??", it would mean all classes starting with the letters "ART" and then having up to two more characters, like "ART10" or "ARTS". When you use one of the five options, you can use the cursor keys to move to the desired class, or use them to change directories or drives, or move the cursor to the line "Files to use:" and type in the file specifications. Whichever field is highlighted when you press <Rtn> will be the field that will determine what action is taken. The options and their actions are listed below. Rename class files ("R") This option can be used to rename one or more files. You are first asked for the file(s) to rename, then are asked for the new name(s). All files that match the listed file names will be renamed. Only the first of two or more classes that should be renamed to duplicate names will be renamed. Update class files ("U") This option will look at all class files in the first directory or drive that you choose, then copy them to a second directory or drive if they are more recent than those in that second one. If you have more than one class in a directory, this will let you update (or backup) all those files at once, rather that one at a time as in "W", above. Copy class files ("C") This option will copy all class files that you specify to new drives or directories. This differs from update in that update only copies classes that are also in the second directory or drive, while copy copies them whether or not they already exist in the specified directory or drive. 104 Other Program Features Move class files ("M") Moving class files will copy the specified classes into the new directory or drive, then delete them from the first. This option is useful for archiving classes after the semester or year is finished. Delete class files ("D") This option will delete all the specified class files. WARNING: This option will remove whatever class files you specify. Be sure you have picked the ones you really want to delete. Note that you are asked if you are sure that you want to delete those classes before the program actually removes them. Write/Not write backup files ("B") Backup files are normally made of your grades. These backups contain the data from the previous time that you saved your data. The backup files have the same name as the class, but have the extensions ".DAX" and ".PAX". NOTE: The appendix gives more information on these files. No matter in which type of file the class data is written (read-only, hidden, or normal), the backup files are made normal files. This means that they can be deleted should you not want to clutter up your disk with them. However, if you prefer not to have the program make backup files, you can use this option to prevent backups. It is strongly recommended that you let back-up files be made and that you let the program write the class files as read-only. The combination of these two options will give your data much greater security. Change class protection ("P") The class grade files are, by default, written in what is known as "read-only" files. This means that if you are in DOS and ask that the files be deleted, they will not be deleted by DOS. The program does this to prevent accidental deletions of the data, but this can sometimes cause problems with other programs, most notably some backup programs. You can change the way files are written by specifying that they be written normally (they can be deleted by DOS), as read- only files, or that they be "hidden" files (DOS will not even list the files on a "dir" command). Hidden files will still be seen by VAR Grade, but not by anyone casually snooping around your disk. 105 B. Running Other Programs from VAR Grade If necessary, you can use the "R" option on the Main Menu to run other programs from VAR Grade. This feature was put into the program to allow you to delete files or format disks without exiting the program. These may be necessary if you run out of disk space before writing data to a disk file. With this option, however, if you have enough memory you can run any program. To remind you that you are still in VAR Grade, the prompt will be preceded by a message: "To return to VAR Grade, type EXIT." You should be warned that certain programs may cause problems. The major problems can come from programs that are memory resident or that will (inadvertently) stall ("hang") the computer. Because there is no reasonable way for VAR Grade to prevent you from running these types of programs, it is advised that you save your data before running programs other than those of the DOS operating system (del, format, dir, etc.). When running other programs from VAR Grade, or when choosing new printers or editing reports forms (see below), VAR Grade will try to free up as much memory as possible. It will therefore try to move itself into EMS memory or onto a disk (if you have a hard/fixed disk), and will give a message to you as to what it is doing (e.g., "Swapping to disk") when it is doing so. This will free up much more memory for running these other programs. In fact, VAR Grade will use less than 10K of memory when running other programs if it is able to swap itself to either EMS or a hard disk. If you do not want VAR Grade to swap the data in memory to a disk file, you can prevent this. On the Parameters Menu ("Z" on the Main Menu), you can tell the program not to use a disk file to save memory. C. Dates You can redefine the method of writing the date. You can define dates a variety of ways, including American, Japanese, and European style dates. This can be found on the "Z" option of the Main Menu. These dates are used for writing data. It is also used in defining attendance days. D. Video Displays VAR Grade supports all standard displays. There are some points below that may help you. 106 Other Program Features 1. Monochrome displays Some monochrome display adapters tell programs that they are color boards. This causes the program to write data to the screen that looks funny or unreadable. If you have a monochrome board and the opening screen has a lot of underlined characters, there are two things you can do to improve the display. (a) Start the program with a switch Instead of starting the program with "GRADE", start it with "GRADE/B". The /B is a switch that tells the program that you have a black and white display. This has to be done each time you run the program. An analogous switch, "GRADE/C" will force the program into color mode. (b) Set a DOS environment variable Rather than typing /B all the time, you can set a DOS variable, instead. Before running the program, type "SET VMON=BW;". This tells the program that you have a black and white display. The best thing would be for you to set this variable in the AUTOEXEC.BAT file that DOS reads when booting the computer. Example: You can do this by typing, at the DOS prompt, "COPY CON AUTOEXEC.BAT" then <Rtn>. Then type "SET VMON=BW;", then <CtrlZ>. This will add one line to your AUTOEXEC.BAT file. Alternatively, set up a batch file that starts VAR Grade: Example: Prepare a file called G.BAT the has the following lines: SET VMON=BW; GRADE SET VMON=; This will set the variable, run the program, then remove it from the environment. Some suggested batch files for use with VAR Grade are given later in this chapter. 107 2. EGA If you have an EGA board, you can display 43 lines on the screen. Go to the "Z" option of the Main Menu, then pick "V". You can pick whether to show 25 or more lines. 3. VGA and Super VGA For VGA boards, you can display 50 lines. For most super VGA boards, you can display even more lines. If you have a Video 7, Paradise, Orchid, or Tseng Labs Super VGA video adapter boards, the program will automatically allow you to print with 800x600 graphics. In addition, super VGA boards from these companies, as well as ATI Technologies, Chips and Technologies, Genoa, and Trident, will allow you to have more than 80 characters on a line. If the program doesn't correctly recognize your board, you can set a DOS variable to tell the program which board you have. You can have up to 132 characters per line and up to 60 lines per screen, depending on the board. For Video 7 boards, type the following line (or put it in your AUTOEXEC.BAT file): "SET VMON=VIDEO7;". If you have a Video 7 board and black-and-white monitor, add the line: "SET VMON=VIDEO7;BW;". For the Orchid boards, replace "VIDEO7" in the above examples with "ORCHID". For the Paradise boards, replace "VIDEO7" with "PARADISE", and for the Tseng Labs boards, replace it with "TSENG". For Genoa boards, use "GENOA", for ATI Technologies, use "ATI", for Trident boards, use "TRIDENT", and for Chips and Technologies, use "CHIPS". Many video boards from other companies use the chips from one of these manufacturers. For example, EMK boards use the Paradise VGA chips. NOTE: If the screen looks funny after changing the display, your board will not go into the mode you chose. You need to set the display back to one that your board is capable of using by pressing "V" and then "1". 4. Other Graphics Some video adapters are not detectable by VAR Grade. In those cases, you will get funny looking plots. To let you use the correct BGI driver for your adapter, an additional command has been added. Type "SET BGI=x;", where x is the name of the BGI driver, at the DOS prompt before using the program. If you need this command, you will probably want 108 Other Program Features to add it to your Autoexec.bat file so that you don't have to type it in each time you use your computer. Example: A> SET BGI=Herc; This example will tell the program to use the Hercules video driver (Herc.BGI). For some drivers, there is more than one option (called "MODE") for how to set your screen for graphics. You can tell the program which mode to put the screen into by entering the number after the name of the BGI driver. Example: A> SET BGI=VGA16 8; This example will tell the program to use the VGA16 video driver (VGA16.BGI), and set the screen mode to mode 8 (for Video7 800x600 mode). The VGA16.BGI file (written by John Sieraski) is currently the only driver that needs to be set at different modes for different video adapters. Note that if your display is compatible with modes 4 through 9, VAR Grade should automatically use the 800x600 mode. If the screen has garbage on it when plotting, the incorrect mode was chosen. You can prevent this by going to the "Z" option on the Main Menu, then "V". Choose option "0". The VGA16 modes are: VGA16 Mode Description Screen Resolution 0 EGA/VGA 320x200 1 EGA/VGA 640x200 2 EGA/VGA 640x350 3 VGA 640x480 4 ATI VGA 800x600 5 Orchid VGA 800x600 6 Paradise VGA 800x600 7 VEGA VGA 800x600 8 Video7 VGA 800x600 9 SOTA VGA-16 800x600 E. GrUtil.Exe If you want a simple way to print empty grids for entering student grades or to load students from text files into a class, you can either use VAR Grade or GrUtil. GrUtil can be used as a batch file or you can use VAR Grade, and follow the directions. Batch files can be set up for your standard grid and loading conditions. 109 1. Writing grids with GrUtil Grids are lists of student names and empty cells for entering scores. The program needs to know the name of the text file of students, the name of the class, and whether to print names, IDs, or both. The syntax is as follows: Start the program with "GrUtil", then put the classname on the command line, followed by the word GRID (in upper or lower case). If you want to print IDs (I) or both names and IDs (B), put the appropriate letter after GRID. Examples ("A>" is the MS-DOS prompt): A> GRUTIL Classname GRID Prints names and a grid for the students in Classname. A> GRUTIL Classname GRID B Prints names AND IDs and a grid for students in Classname. Classname is any VAR Grade class. Attendance grids, which have twice as many boxes as regular grids, can be printed by using "AGRID" instead of "GRID". 2. Loading students with GrUtil Section D of Chapter VI, Entering Students, explains how VAR Grade can be used to enter student data into the class. You can do the same types of imports with GrUtil. However, GrUtil runs as a batch file. Batch files require no keyboard input from you. Preparation of the files is the same as described above. (i) Pick the name of the file that has the student names. The file should be a text file of one student per line. The names and IDs can be anywhere on the line, and extraneous characters won't interfere with this utility. Ideally, all lines in the text file not containing students should be removed. (ii) If the file is a comma and quote file, type the following: A> GRUTIL Classname CommaFile COMMA 110 Other Program Features Classname is the name of the class in which to add the new students. CommaFile is the full name (with extension) of the comma and quote file. (iii) If the file is a flat file, type one of the following: A> GRUTIL Classname FlatFile or A> GRUTIL Classname FlatFile # # # # # # # # Classname is the name of the class in which to add the new students. Flatfile is the full name (with extension) of the flat file. You can add up to eight numbers. The first two are the beginning and ending columns of the Names. The next two are the beginning and ending of the IDs, the next two are the beginning and ending of notes, and the last two are the beginning and ending of the sections. If no numbers are there, or if one of the first two numbers is 0, GrUtil tries to make sense of the data, with the same method that VAR Grade uses when automatically importing flat files. Otherwise, GrUtil uses the columns you have specified to load the names, IDs, and sections. A zero in the beginning of the IDs or sections tells GrUtil that no IDs or sections are in the file. Examples ("A>" is the MS-DOS prompt): A> GRUTIL Classname Flatfile 1 20 22 36 Loads names from Flatfile into section 1 of class. The names start at character 1 and end at 20, the IDs start at 22 and end at 36. A> GRUTIL Classname Flatfile 1 10 0 Loads names from Flatfile into section 1 of classname. The names start at character 1 and end at 10, the IDs start at 0, hence do not exist. A> GRUTIL Classname Flatfile 21 35 1 15 16 18 Loads names from Flatfile into sections found in characters 16 to 18 of classname. The names start at character 21 and end at 35, the IDs start at character 1 and end at 15. 111 F. Examples of VAR Grade Batch Files If you are familiar with MS-DOS, the following are examples of how to set up batch files to do what you want with VAR Grade. For all the examples, it is assumed that you are using MS-DOS 3.0 or later, and that the program is in the directory C:\VARGRADE. Classname is a name of any valid VAR Grade class. Preparing Batch files: The easiest way to prepare the following files is to use a word processor that will write the data to disk files in ASCII format. To prepare the batch files from MS-DOS, type the following (A> is the DOS prompt, the material between the [], below, tells you what to do): A> COPY CON batchfilename<Rtn> [type in one of the batch files listed below] <CtrlZ> [simultaneously press the <Ctrl> key and "Z"] A> GR.BAT: Batch file to run VAR Grade from any directory. Put it in your directory where DOS is, or in one specified by the PATH command. Start it from DOS by typing "GR Classname". @ECHO OFF @REM CALL WITH "GR Classname" IF %1Z == Z GOTO ERR SET LASTPATH=%PATH% SET PATH=C:\VARGRADE;%PATH% C:\VARGRADE\GRADE %1 SET PATH=%LASTPATH% GOTO END :ERR ECHO ERROR! RUN GR WITH: "GR Classname" :END 112 Other Program Features You may want to add parts of some of the following batch files to GR.BAT to fit your needs. GM.BAT: Batch file if you have a monochrome monitor. Put it in your directory where DOS is, or in one specified by the PATH command. Start it from DOS by typing "GM Classname". SET VMON=BW; C:\VARGRADE\GRADE %1 GMin.BAT: Batch file to reduce the memory used by VAR Grade. Put it in your directory where DOS is, or in one specified by the PATH command. Start it from DOS by typing "GMin Classname". SET OMEM=0; C:\VARGRADE\GRADE %1 GMax.BAT: Batch file to increase the memory used by VAR Grade, thereby reducing the disk accesses, and increasing the speed of parts of the program. Put it in your directory where DOS is, or in one specified by the PATH command. Start it from DOS by typing "GMem Classname". SET OMEM=250000; C:\VARGRADE\GRADE %1 GRID.BAT: Batch file to print grids of any class. Put it in your directory where DOS is, or in one specified by the PATH command. Start it from DOS by typing "GRID Classname". @ECHO OFF @REM CALL WITH "GRID Classname" @REM WRITES AN EMPTY GRID FOR DATA ENTRY IN CLASSNAME IF %1Z == Z GOTO ERR GRUTIL %1 GRID GOTO END :ERR ECHO ERROR! RUN GRID WITH: "GRID Classname" :END 113 LOAD.BAT: Batch file to load students from a flat file into VAR Grade. The example below uses numbers for the starting and ending positions of the names and IDs. These are examples. Your file will probably have different starting and ending positions for the data. Start it from DOS by typing "LOAD Classname". @ECHO OFF @REM CALL WITH "LOAD Classname Flatfile.ext" @REM READS FLATFILE OF NAMES INTO SECTION 1 OF CLASSNAME IF %1Z == Z GOTO ERR IF %2Z == Z GOTO ERR GRUTIL %1 %2 1 20 25 39 GOTO END :ERR ECHO ERROR! RUN LOAD WITH: "LOAD Classname Flatfile.ext" :END 114 Appendix XIII. APPENDIX A. Program Parameters--Defaults and Limits The default values are those that are there when the program starts. Parameter Default Maximum Students 0 16000 Sections 1 254 Tasks (total) 0 8000 Total points for a number task 0 1000000 Total points per sum task 0 9999999 Attendance Days 0 240 Backups made Yes - Password used No - Printing--default values (modifiable): Lines per page 60 30000 Characters per line 80 255 Type size Pica Type quality Draft Line spacing Single Left margin 0 Lines in header 5 Lines in the footer 5 Page numbers printed Yes B. Backup Files 1. Preventing Data Loss It is very important to prevent data from being lost. There are several things that the program does to prevent this loss. 1. You cannot exit the program without telling it whether you want your data saved. 115 2. You cannot accidentally exit the program (e.g. disk drive door open, printer not turned on), except from a power failure or by rebooting the computer. 3. Files are written in read-only format by default. You cannot delete or erase these files in DOS. The default can be changed to "normal" (if you do not fear deleting your class grades), or "hidden". 4. When files are written to disk, the program checks to make sure the files were written with the correct size (hence were probably correctly written). 5. When files are written to disk, the previous class data is turned into backup files. The file CLASSNAME.PAR is changed to CLASSNAME.PAX. The file CLASSNAME.DAT is changed to CLASSNAME.DAX. These backup files are not read-only, and can be deleted by DOS. Should you want to delete old class files, use the DOS 3.x command Attrib to change the file attribute to "normal", then delete the file. Example, type: A> ATTRIB -R CLASSNAME.* A> DEL CLASSNAME.* You can tell the program to stop making backup files, but we recommend that you do this only if disk space is at a premium. 6. If a fatal error occurs during program execution, VAR Grade will try to save any new data put into the program. Its success depends upon the nature of the fatal error. A fatal error is one that prevents the program from executing correctly. Although great care has been taken to prevent such errors, they may still occur. Therefore, it is suggested that you immediately save your data to disk when you have entered new data. It is also recommended that you also print the data on your printer to have another copy of it. 2. Recovering Old Data To recover the information in the backup files, you must first exit VAR Grade. When in DOS, rename them so that the file that ends in ".PAX" ends in ".PAR" and the file that 116 Appendix ends in ".DAX" ends in ".DAT". Both files must have the same classname. At the MS-DOS prompts (A>), type: A> RENAME ACLASS.PAX ACLASS2.PAR A> RENAME ACLASS.DAX ACLASS2.DAT ACLASS2 will have the data from the PREVIOUS update of the data--NOT the most recent update. C. Beeps or Noises If the computer beeps or makes a noise, there are two possible reasons. First, you could have entered a number too high or low for the task. This warning can either be changed to a louder pitch or turned off in the "Z" section of the Main Menu. Second, the memory may be quite low, so that the information in a screen window could not be saved. When the current window is finished, it probably will not be able to redraw the underlying window correctly. Pressing <AltR> will usually redraw the screen. The program should run correctly when memory is low; however, not all students, tasks, or attendance days may be listed when memory is low. If you get one beep, more will probably occur due to the limited memory. Since memory is low, you should probably exit the program, free up some memory, and then re-run VAR Grade. One way to free up memory is by setting a MS-DOS variable OMEM=0, then reentering the program. Example: At the DOS prompt (A>), type: A> SET OMEM=0; D. Menus The following is a list of the major Menus in VAR Grade. They are arranged in a hierarchy, so an indent is one menu down in the hierarchy. Add Names Menu Add Names Menu (cont) Type in names Move section Type in names and IDs Delete section Import flat files Delete all students Import flat files Individual Task Form automatically Student Task Form Import comma and quote Task Type Menu files Import one task 117 Attendance Menu Plot Menu (cont) Student Attendance Form Correlate two tests with Individual Attendance 3D bars Form Plot class statistics Define new attendance Plot an individual versus dates class statistics Default Attendance Task Change fonts Values Grading Menu Attendance defaults Assign grades Save Class Data Plot and assign grades File Maintainance Plot with 3D bars and Alter class file name assign grades Write backup file Scale tasks Rename classes Assign T-scores Update classes Assign standard Copy classes deviations Move classes Change grade names Delete classes Assign cutoffs File protection Remove cutoffs Toggle backups Adjust statistics for a Write Data Menu task Print by section Delete adjustments of Print by name statistics Pick tasks, list by name Set the fewest allowed Print grids points Print attendance grids Parameters Menu Write individual reports Time and dates Write class reports Video display lines Edit reports Color Designate editor Passwords Export quote and comma Beep on input error file Class name Export flat file Decimal places Export byte file Printer Menu Help Pick a new printer Manual Set user defined line Plot Menu codes Plot the scores in 2D Line printer codes bars Set character size Plot the scores in 3D Set print quality bars Set the printer port List students on a task Page and line settings (no plot) Sorting Plot individual trends in Default sections 2D bars Numbers of sections Plot individual trends in DOS shell 3D bars Quit the class Correlate two tests Get another class 118 Glossary XIV. GLOSSARY Archive Files that have been compressed so that they take up less space on the disk. They need to be unarchived to be used. ASCII A standard code that translates normal characters and symbols into 7 bit binary computer code. Autoexec.BAT When you start your computer, it looks for this file to get information about the operating environment. Bars Squares used to depict student scores in the plots. They can look two dimensional or three dimensional. Batch One of three types of files that MS-DOS can execute. Batch files are written in ASCII characters, with each line telling MS-DOS what to do. Cell A highlighted area of the screen that holds one piece of data. Comma & Quote Files Files that have strings of characters between double quotes (""), and commas separating pieces of data. Numbers are separated only by commas. Cursor Keys Keys that move the position of the cursor on the screen. They include the arrow keys, the home, end, page up, and page down keys. Default The value when the program starts. Directory Group of files on a disk. Files on hard disks are usually grouped together in directories to make it easier to find the file you need. Drives are also directories. 119 Display Adapter A card in the computer that controls the monitor. It can be a Hercules card, CGA, EGA, or VGA card, as well as other cards. Edit Keys When edit keys are used, the left and right arrow cursor keys move within a cell instead of between cells, and the home and end keys move to the beginning and end of the cell. To "use" edit keys means that you can use the left and right arrow, home, and end keys to move around a cell. To move between cells when "using" edit keys, you need to use <Ctrl>-arrow keys. EMS memory Memory above 640K. If you have 1 megabyte or more memory and a program that can map this memory for DOS commands, like EMM.SYS or EMM386.SYS, programs like VAR Grade can make use of this memory. Fixed Disk A disk that cannot be removed from the computer. Flat Files Files that have data in columns, separated by spaces. Floppy Disk A disk that can be removed from a drive. Hard Disk A disk that cannot be removed from the computer. Install Put the files needed by a program onto new disks such that the new disks have the program files in the places needed by that program. Line Printer A printer that prints non-graphics characters. All printers are line printers. Main Menu The menu that lists the major sections of the program. Menu-driven Uses menus to let you reach all parts and features of the program. Monochrome Black and white. 120 Glossary Overlay The part of the program that is in memory only when needed. It is read in from a disk when it is needed. Path A list of directories that tells MS-DOS where executable programs are. The path is set by typing "SET PATH=directory1;directory2;" at the DOS prompt, where directory1 and directory2, etc., are names of directories. Ports Printers are connected to either serial or parallel cards in your computer. Each card has a different designation for its address. These addresses are the ports. Printer Codes Codes sent to the printer to control how it prints data. Regular tasks Those tasks that you can put in new data. They are the number, letter, and extra credit tasks. Special keys Special keys are those that do not print normal (ASCII) keys. The function keys (<F1> through <F10>), the <Alt>, <Ctrl>, <Ins>, <Del>, and the cursor keys. Special tasks Those tasks that are calculated by the program. You cannot put in new scores into these tasks. Task A graded assignment for the class. Toggle Turn on and off. Wildcard The characters * and ? are used by MS-DOS to match more than one character, as a wild card, when playing cards, can match any other card. 121 XV. FURTHER INFORMATION This program is COPYRIGHTED (C) 1987-91 by Dennis Revie. All rights are reserved. Schools, school districts, and colleges and universities can get a site license ("group" register) VAR Grade at reduced rates. Write for details, including information on special needs. A. Information This manual should contain most of your questions. Should you need further assistance, either to clarify parts of the program, to suggest changes, to report bugs, or to obtain a custom version of the program, write to the address below. You will receive a prompt reply. This program is user supported and your comments are encouraged. Details on registration are listed near the beginning of the program. B. Registration This program can be distributed as SHAREWARE. It is not free. You may use it on a preview basis only. If you find the program useful, you MUST register it by sending $30 (for registration only) or $40 (to register and also receive a laser-printed manual) in US dollars to the address below. See the notice starting on page i for more details. Dennis Revie Attn: VAR GRADE 4804 Highland Ave Oxnard, CA 93033-7818 Modem (information only): CIS: 73427,112 122